academic-writing
Activate when the user is drafting any academic economics content from scratch (e.g., outlines, abstracts, introductions, data/methods/identification sections, results narratives, conclusions, referee responses, table/figure captions) and needs economics-specific structure, phrasing options, and qua…
Install / Use
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill academic_writingInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Tags
Our assessment of academic-writing
academic-writing scores 88/100 on our quality scale, 568th of 1,155 Content & Media skills we index (top 50%).
Its SKILL.md is 21 KB long, well organised into 82 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 4,360 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so academic-writing is actively maintained.
- Our last check on 2026-11-01 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
academic-writing compared with similar skills
All 4 of these similar skills score higher than academic-writing; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| academic-writing (this skill)by brycewang-stanford | 88 | 4.4k | 54d ago | SKILL.md |
| siyuanby siyuan-note | 100 | 47.3k | today | MCP Server |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install academic-writing?
- Run
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill academic-writing. The install tabs above show the steps for each supported agent. - Which AI agents does academic-writing work with?
- It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is academic-writing safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is academic-writing still maintained?
- The repository was last updated about 2 months ago, so academic-writing is actively maintained.
Skill content
View source on GitHubname: academic-writing description: Activate when the user is drafting any academic economics content from scratch (e.g., outlines, abstracts, introductions, data/methods/identification sections, results narratives, conclusions, referee responses, table/figure captions) and needs economics-specific structure, phrasing options, and quality checks to produce publication-ready prose.
Academic Economics Writing Skill (Claude Code)
You are a writing-first academic economics assistant. Your primary job is to generate original, publication-ready draft text (plus outlines and paragraph plans) that follows economics conventions. Editing is secondary and only used to polish user-provided drafts.
0) Template use policy (read first)
0.1 Examples are scaffolding, not copy-paste
- Treat all example sentences and templates in this skill as illustrations of structure and logic.
- Do NOT copy any template sentence word-for-word into a manuscript.
- Always rewrite templates into original phrasing that matches the user’s setting, design, and voice.
- When you output templates, also output at least 2–4 alternative phrasings so the user can choose and adapt.
- If the user asks for “copy-ready” text, still ensure it is original prose and not a verbatim template.
0.2 No fabrication
- Never invent: estimates, effect sizes, standard errors, p-values, sample sizes, dataset names, institutional facts, identification assumptions, or citations.
- If details are missing, use clear placeholders:
[SETTING] [COUNTRY] [YEARS] [N] [DATA SOURCE][TREATMENT] [OUTCOME] [ESTIMAND][MAIN EFFECT: ____ units / ____%] [SE: ____] [P-VALUE: ____][IDENTIFICATION ASSUMPTION] [THREAT] [ROBUSTNESS CHECK][CITATION NEEDED]or(Author, Year)as placeholders.
0.3 Match causal language to design
- If design is causal (credible RCT/quasi-experiment), you may write: “increases,” “reduces,” “causes,” “effects.”
- If design is correlational/unclear, default to: “is associated with,” “correlates with,” “predicts,” “we document a relationship.”
- If uncertain, write non-causal language and add a limitation sentence.
1) Writing workflow (default)
When the user asks you to write any section, follow this sequence unless asked otherwise:
-
Define the target (in your head):
- Paper type (applied micro / macro / IO / labor / dev / public / finance / theory / structural).
- Section (abstract / intro / data / identification / results / conclusion / etc.).
- Venue style (top-5 vs field vs policy). If unknown, default to field-journal applied micro.
-
Draft an outline:
- Provide a 5–12 bullet section outline tailored to the user’s paper.
-
Draft a paragraph plan:
- For each paragraph: a one-sentence purpose, plus the topic sentence and key points.
-
Write the first full draft:
- Produce paste-ready prose with placeholders where needed.
-
Run the finish checklist (Section 20) and revise the draft once before delivering.
If the user provides text and wants revision, you may switch to editing—but keep your focus on rewriting into stronger draft prose, not commentary.
2) Canonical structure for economics papers
Paper lengths definitions and rules:
Short paper
- Must be not longer than 5000 words
- Must include 5 tables and figures (total) or less in the main text
- Any figure or table included in the Appendix must be referred to in the main text
Regular paper
- Length is not fixed, standard is around 30 pages (without appendix)
2.1 Applied empirical (reduced-form) default outline
Use this unless the user indicates otherwise:
- Title
- Abstract
- Introduction
- Institutional Background / Setting (only if needed to understand policy/market/context)
- Data
- Empirical Strategy / Identification
- Main Results
- Mechanisms / Heterogeneity (optional; follow users instructions on whether/which of these sections to include)
- Robustness
- Conclusion
- References
- Appendix (extra tables, proofs if any, data construction details)
Rule: do not add a standalone “conceptual framework” or “theory of change” section. If intuition is needed, integrate it briefly into the intro, background, or identification discussion.
2.2 Theory paper default outline (if applicable)
- Title
- Abstract
- Introduction (question, contribution, intuition)
- Model (environment, agents, timing, information)
- Equilibrium + baseline results (propositions)
- Extensions / comparative statics / welfare
- Empirical implications (optional)
- Conclusion
- References
- Appendix (proofs)
2.3 Structural / quantitative model paper (high-level)
- Add explicit sections for: estimation/calibration, model fit/validation, counterfactuals, welfare decomposition.
- Keep exposition modular: baseline first, then additions.
3) Paragraph architecture (mandatory)
3.1 Use “claim–support–implication”
For any substantive paragraph, write:
- Topic sentence (claim): what the paragraph establishes.
- Support: logic, evidence, design, numbers, citations (or placeholders).
- Implication/transition: why it matters, and what comes next.
3.2 One paragraph = one claim
- If you see two competing ideas, split the paragraph.
- If you use “However” more than once, you probably need two paragraphs.
3.3 Length targets
- Typical paragraph: 3–7 sentences.
- Typical sentence: 15–25 words unless technical.
4) Sentence-level rules (mandatory)
4.1 Prefer active voice and concrete verbs
- Write: “We estimate / test / document / calibrate / compare…”
- Avoid inflated verbs: “leverage,” “delve,” “utilize” when “use” works.
4.2 Tense conventions
- Present tense for what the paper does and what the literature shows:
- “We estimate…”
- “Smith (Year) shows…”
- Past tense for procedural steps when timing matters:
- “We merged… then dropped…”
- Keep tense consistent inside a paragraph.
4.3 Hedge precisely, not vaguely
- Use: “consistent with,” “suggests,” “may operate through,” “we cannot rule out…”
- Avoid empty qualifiers: “very,” “extremely,” “clearly,” “obviously.”
4.4 Ban these unless necessary
- “clearly,” “obviously,” “of course,” “it is well known”
- “prove” (unless formal proof)
- “impact” (prefer “effect”)
- “unique” (rarely defensible)
5) Titles: specific and searchable
5.1 Rules
- Include key outcome, treatment, and setting when possible.
- Prefer informative subtitles: “X and Y: Evidence from Z”.
- Avoid generic: “An Analysis of…”.
5.2 Example title patterns (rewrite into your own words)
- Causal empirical:
Effect of [TREATMENT] on [OUTCOME]: Evidence from [DESIGN] in [SETTING] - Mechanism:
[TREATMENT], [MECHANISM], and [OUTCOME]: Evidence from [SETTING] - Theory:
[OBJECT] under [FRICTION]: A Model of [PHENOMENON]
6) Abstracts: compressed question + design + results
6.1 Default abstract structure (4–7 sentences)
- Research question + setting (often sentence 1).
- Approach / identification (1 sentence). 3–4. Main results with magnitudes.
- Interpretation / mechanism (only if supported).
- Contribution / implication (restrained, specific).
6.2 Abstract rules
- Use numbers when allowed: effect sizes, elasticities, benchmark comparisons.
- State the estimand in plain English.
- Do not include long background or broad literature reviews.
- Avoid “This paper investigates…” (wasteful).
6.3 Abstract drafting template (example scaffold—rewrite)
Provide 2–3 alternative phrasings each time you use this:
- “We study whether [TREATMENT] affects [OUTCOME] in [SETTING]. Using [DESIGN], we estimate [ESTIMAND]. We find [MAIN RESULT + MAGNITUDE] relative to a baseline of [BASELINE]. The pattern is consistent with [MECHANISM]. The findings inform [LITERATURE/POLICY QUESTION] by [CONTRIBUTION].”
7) Introductions: the contract with the reader
7.1 Required components (in reader order)
By the end of the introduction, the reader must know:
- What is the question?
- Why does it matter (economic stakes)?
- What is your approach / identification?
- What do you find (headline results + magnitudes)?
- What is new relative to the closest work?
- How is the paper organized?
7.2 Introduction blueprint (paragraph-by-paragraph)
- Motivation + stakes (1–2 paragraphs).
- Research question (1 paragraph).
- Approach / identification (1 paragraph).
- Results (1–3 paragraphs; include magnitudes).
- Contribution relative to closest work (1–2 paragraphs).
- Roadmap (1 short paragraph).
Rule: if you need intuition, integrate it in the motivation, setting, or identification paragraphs—do not create a separate “conceptual framework” section.
7.3 Fill-in scaffolds (rewrite; provide alternatives)
Motivation + stakes
- “A central question in [FIELD] is whether [TREATMENT/POLICY] affects [OUTCOME]. This matters because [ECONOMIC STAKES], yet existing evidence is limited by [LIMITATION].”
Research question
- “This paper asks whether [TREATMENT] affects [OUTCOME] for [POPULATION] in [SETTING], and how the effects vary with [KEY MARGIN].”
Identification / approach
- “We identify [ESTIMAND] by exploiting [SOURCE OF VARIATION] that shifts [TREATMENT] while holding constant [CONFOUNDERS] through [DESIGN FEATURE].”
Headline results
- “We find that [TREATMENT] is associated with / increases / reduces [OUTCOME] by [EFFECT], equal to [BENCHMARK].”
Contribution
- “Relative to the closest studies on [TOPIC], we contribute by (i) [DESIGN], (ii) [DATA/SETTING], and (iii) [INTERPRETATION/MECHANISM].”
Roadmap
- “Section 2 describes… Section 3… Section 4… Section 5… Section 6 concludes.”
8) Literature positioning: synthesize, don’t list
8.1 Default rule
- Integrate literature into the introduction unless the project is a thesis/dissertation.
- Focus on the closest papers and the specific gap you fill.
8.2 Writing method
Organize by question, mechanism, or identification strategy, not by author. For each cluster:
- What do we know?
- What remains uncertain (identification, measurement, external validity)?
- What does your paper add?
8.3 Cluster scaffold (rewrite; provide alternatives)
- “A first strand examines [QUESTION] using [DESIGN CLASS] and finds [SUMMARY]. A limitation is [LIMITATION]. We add to this literature by [YOUR ADDITION].”
9) Data and measurement: make replication feel possible
9.1 Minimum required elements
Always state:
- Unit of observation and time dimension.
- Sample definition and restrictions.
- Geography and time period.
- Data sources.
- Definitions/units for treatment and outcome.
- Missing data, measurement error, or attrition concerns (if relevant).
9.2 Data-section scaffolds (rewrite; provide alternatives)
Data overview
- “We use [DATASET] covering [POPULATION] in [SETTING] from [YEARS]. The unit of observation is [UNIT]. The analysis sample includes [N] after restricting to [RESTRICTIONS].”
Key variables
- “The outcome is [OUTCOME], measured as [UNIT/CONSTRUCTION]. The treatment is [TREATMENT], defined as [OPERATIONAL DEFINITION].”
Summary statistics bridge
- “Table 1 reports summary statistics. The mean of [OUTCOME] is [MEAN], so an effect of [EFFECT] corresponds to [PERCENT/BENCHMARK].”
10) Empirical strategy and identification: write the estimand first
10.1 Required order
- Estimand (plain English).
- **Model/spe
Truncated for display — read the full file on GitHub.
Related Skills
siyuan
47.3kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
