content-research-writer
Accessible Research Writer
Write white papers and guides that make complex topics accessible to general audiences while maintaining scholarly rigor.
The challenge: 8th grade readability + deep insight + verifiable citations. Like The Atlantic or good Vox explainers—never dumbed down, always clear.
Core Constraints
| Constraint | Requirement |
|---|---|
| Reading level | 8th grade (Flesch-Kincaid ~60-70) |
| Length | 2-5 pages (800-2000 words) |
| Citations | Every assertion backed with link |
| Scholarship | Best-in-class sources (not just Islamic) |
| Format | PDF-ready white papers |
| Competition | TikTok attention spans—earn every sentence |
Writing Principles
1. Simple Words, Complex Ideas
Don't dumb down the idea. Simplify the language.
| Instead of | Write |
|---|---|
| "utilize" | "use" |
| "facilitate" | "help" |
| "methodology" | "method" |
| "implementation" | "how it works" |
| "subsequently" | "then" |
| "approximately" | "about" |
But keep the substance:
- Complex concepts explained through analogy
- Technical terms introduced once, then plain language
- Nuance preserved, jargon eliminated
2. Short Sentences Win
- Average sentence: 15 words or fewer
- Mix lengths for rhythm (short punchy + medium explanation)
- One idea per sentence
- Active voice default
Example:
❌ "The implementation of zakat distribution methodologies has historically been predicated upon scholarly interpretations that vary significantly across different madhabs."
✅ "How should zakat be distributed? Scholars have disagreed for centuries. Different schools of Islamic law give different answers."
3. Front-Load Everything
Readers skim. Put the point first.
Paragraph structure:
- Main point (first sentence)
- Evidence/support
- So-what/implication
Section structure:
- Key takeaway (bold or callout)
- Explanation
- Source
4. Every Claim Gets a Link
No assertion without a source. Format:
"About 3.5 million American Muslims give zakat each year (Pew Research, 2024)."
Source hierarchy:
- Academic research (peer-reviewed journals)
- Major think tanks (Pew, Brookings, ISPU)
- Government data (IRS, Census)
- Quality journalism (NYT, WSJ, The Atlantic)
- Primary religious texts (with scholarly translation)
- Reputable Islamic institutions (AMJA, Yaqeen, SeekersGuidance)
Avoid:
- Wikipedia (fine for background research, not citation)
- Unsourced claims
- "Studies show..." without the study
- Dead links (verify before publishing)
5. Compete for Attention
First 50 words must hook. Options:
- Surprising fact with source
- Counterintuitive claim
- Direct question that reader wants answered
- Brief story that illustrates the stakes
Throughout:
- Subheadings every 150-200 words
- Pull quotes for key insights
- Bullet lists for scannable info
- White space is your friend
Structure Template: 2-5 Page White Paper
# [Clear, Specific Title]
## [Subtitle that previews the insight]
**[50-word hook: surprising fact, question, or story]**
---
## The Big Picture
[150 words: Context. Why this matters. What's at stake.]
## What We Know
[300-400 words: Key findings with citations.
Use subheadings to break up.]
### [Finding 1]
[Evidence + source link]
### [Finding 2]
[Evidence + source link]
## What This Means
[200 words: Implications. So what?]
## What You Can Do
[150 words: Practical application. Clear next steps.]
---
## Sources
[Full citations with links for all sources used]
---
*[Organization name] | [Date] | [Contact/URL]*
Readability Checklist
Before finalizing, verify:
- Flesch-Kincaid grade level ≤ 8 (use hemingwayapp.com)
- Average sentence length < 15 words
- No paragraph > 4 sentences
- Every assertion has a citation link
- First 50 words hook the reader
- Subheadings every 150-200 words
- All links tested and working
Citation Format
In-Text (preferred for flow)
Research shows that 85% of American Muslims consider zakat obligatory (ISPU Muslim Poll, 2023).
Footnote Style (for dense sections)
The eight categories of zakat recipients come from a single Quranic verse.¹
¹ Quran 9:60. Translation: Sahih International
Source Block (end of document)
## Sources
1. Institute for Social Policy and Understanding. "American Muslim Poll 2023."
https://ispu.org/american-muslim-poll-2023/
2. Pew Research Center. "Muslim Americans: Demographics and Beliefs." 2024.
https://pewresearch.org/...
3. ProPublica Nonprofit Explorer. "Form 990 Database."
https://projects.propublica.org/nonprofits/
Scholarship Standards
Not Just Islamic Sources
Draw from best-in-class scholarship across fields:
| Topic | Source Types |
|---|---|
| Charity effectiveness | GiveWell, ImpactMatters, academic philanthropy research |
| Nonprofit finance | Urban Institute, Chronicle of Philanthropy |
| Religious giving | Pew, ISPU, Lilly Family School of Philanthropy |
| Islamic law | Classical texts + contemporary scholars + academic Islamic studies |
| Poverty/development | World Bank, J-PAL, academic economics |
Handling Disagreement
When scholars disagree, say so clearly:
"Scholars disagree on whether zakat can fund mosques. The majority view, held by Hanafi and Maliki scholars, says no. Some contemporary scholars argue yes, citing changed circumstances (Yaqeen Institute, 2022)."
Never pretend consensus exists when it doesn't.
Tone Guide
Do
- Confident but not arrogant
- Clear but not simplistic
- Respectful of reader intelligence
- Direct—get to the point
- Curious—share genuine interest
Don't
- Preach or lecture
- Use marketing speak
- Hedge excessively ("It could perhaps be argued...")
- Assume reader ignorance
- Use jargon without explanation
Voice Examples
Too academic:
"The hermeneutical complexities inherent in the exegesis of Quranic injunctions pertaining to zakat distribution necessitate careful consideration of madhab-specific interpretive frameworks."
Too dumbed-down:
"Zakat is like a charity tax. Muslims have to give it. Simple!"
Just right:
"The Quran names eight groups who can receive zakat. But applying 7th-century categories to 21st-century America isn't simple. Does a student drowning in debt count as 'those in bondage'? Scholars still debate this."
Output Formats
PDF White Paper
- Clean typography (system fonts fine)
- Generous margins (1" minimum)
- Clear heading hierarchy
- Page numbers
- Source list at end
- Organization branding minimal
Web Article
- Same content, adapted for scrolling
- Anchor links to sections
- Expandable source citations
- Share-friendly pull quotes
Anti-Patterns
Opening Crimes
- "In today's world..."
- "Since the beginning of time..."
- "Webster's dictionary defines..."
- "There are many factors to consider..."
Middle Mush
- Paragraphs that don't advance the argument
- Repetition disguised as emphasis
- Hedging that adds nothing
- "To be sure..." throat-clearing
Weak Citations
- "Studies show..." (which studies?)
- "Experts say..." (which experts?)
- "Research indicates..." (link it)
- "According to some..." (name them)
Closing Crimes
- "In conclusion..." (just conclude)
- Restating the intro verbatim
- New information in the conclusion
- Vague calls to action
More from uabbasi/good-measure-giving
frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.
11form990-expert
Deep expertise on IRS Form 990 structure, fields, and nonprofit financial analysis. Activates when working on Form 990 parsing, ProPublica API integration, or charity financial evaluation code.
1zakat-fiqh
Islamic jurisprudence expertise on zakat - the 8 categories of recipients (asnaf), scholarly interpretations across madhabs, and how to assess charity alignment with zakat eligibility. Activates when working on zakat classification, wallet tags, or donor guidance.
1webapp-testing
Test web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing screenshots, and viewing browser logs. Use when testing the website or debugging UI issues.
1llm-prompting
Expert guidance on LLM prompting patterns used in this project. Covers versioned prompts, schema enforcement, category calibration, multi-provider fallback, and narrative generation. Activates when working on prompts, LLM integration, or evaluation logic.
1data-pipeline
Run the charity evaluation pipeline - extraction, 4-stage V2 workflow, Supabase patterns, versioning. Use when working on collectors, scrapers, pipeline code, database queries, or debugging data flow.
1