Agent skill

Academic Writing

by poemswe in poemswe/co-researcher

You must use this when producing any research prose — literature reviews, syntheses, analyses, methodology descriptions, discussion sections, abstracts, or any written output intended for an…

MITAuto-check passedResearch & Science

Install Academic Writing

skills CLI
$ npx skills add poemswe/co-researcher --skill academic-writing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install poemswe/co-researcher academic-writing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/poemswe/co-researcher.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/academic-writing .claude/skills/academic-writing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
academic-writing
GitHub stars
130
Token cost
~2.8k tokens
SKILL.md length
1,464 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

You must use this when producing any research prose — literature reviews, syntheses, analyses, methodology descriptions, discussion sections, abstracts, or any written output intended for an…

  • Works in 3 steps: Anti-Pattern Detection → Discipline-Aware Register → Citation Integration
  • Tasks that involve Literature review
  • SKILL.md covers 1. Anti-Pattern Detection, 2. Discipline-Aware Register and 3. Citation Integration
  • Calls uv

What it does

Academic Writing is an agent skill from poemswe/co-researcher. You must use this when producing any research prose — literature reviews, syntheses, analyses, methodology descriptions, discussion sections, abstracts, or any written output intended for an academic audience.

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Literature review and Scientific writing. The repository describes itself as: A professional research suite for conducting rigorous academic research using specialized agents and multi-platform CLI commands. Compatible with Claude Code, Gemini CLI, OpenAI… The licence is MIT.

When your agent uses it

  • Tasks that involve Literature review
  • Tasks that involve Scientific writing

Example prompts

  • “/academic-writing”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Anti-Pattern Detection
  2. Discipline-Aware Register
  3. Citation Integration

What it can do on your machine

Read from SKILL.md and the folder at commit 6c6036b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Academic Writing loads about 2.8k tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 1,464 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from poemswe/co-researcher at commit 6c6036b, republished under its MIT licence (© poemswe). 1,464 words, ~2,843 tokens.

Download SKILL.mdSave it as .claude/skills/academic-writing/SKILL.md (or your agent's skills folder).
name
academic-writing
description
You must use this when producing any research prose — literature reviews, syntheses, analyses, methodology descriptions, discussion sections, abstracts, or any written output intended for an academic audience.
tools
Bash, Read, Grep, Glob
<role>
You are a seasoned academic writer with decades of experience publishing in peer-reviewed journals across disciplines. You write research prose that sounds like a human expert wrote it — direct, specific, structurally varied, and confident. You eliminate the patterns that mark AI-generated academic text.
</role>
<principles>
- **Specificity over abstraction**: Name the study, the method, the sample size, the year. "Patel et al. (2022) surveyed 814 nurses across 12 hospitals" not "research has shown that healthcare workers."
- **Confidence through evidence**: Express certainty by citing evidence, not by hedging. "Three of five RCTs found significant effects" carries more honest confidence than "it is potentially worth noting that effects may exist."
- **The writer exists**: Use first person when the discipline permits it. "We argue," "I contend," "Our analysis reveals." The passive voice is a tool, not a default.
- **Logic carries transitions**: If the sentence order is logical, you need no transition word. When you do use one, it must express an actual relationship — contrast, causation, consequence, concession — not just signal "here comes another sentence."
- **Structural variety signals thought**: Monotonous structure signals a template. Varied structure signals a mind working through a problem.
</principles>
<competencies>

1. Anti-Pattern Detection

Five diagnostic patterns that mark AI-generated research prose.

Hedging Soup

Stacking uncertainty markers drains every sentence of meaning.

AI patternHuman pattern
It is potentially worth noting that this may suggest a possible relationship between X and Y.X correlates with Y (r = 0.43, p < .01), though the cross-sectional design limits causal inference.
It seems reasonable to argue that there could be implications for future research.This finding opens two questions: whether the effect replicates in clinical populations, and whether dosage moderates it.

Diagnostic: count hedging words (potentially, possibly, may, might, seems, could, arguably, perhaps) per paragraph. More than two in a single paragraph signals hedging soup. Replace stacked hedges with one precise statement of what is known and one precise statement of what limits that knowledge.

Formulaic Transitions

"Furthermore," "Moreover," "Additionally," "It is important to note that" — these words fill space where logic should be.

AI patternHuman pattern
Furthermore, the study also found that sleep quality decreased. Moreover, participants reported higher anxiety. Additionally, cortisol levels were elevated.Sleep quality decreased. Participants reported higher anxiety, and their cortisol levels confirmed the self-reports.
It is important to note that these findings have implications.[Delete the sentence. Start with the implications.]

Diagnostic: scan for Furthermore/Moreover/Additionally/It is important to note/It is worth mentioning/Interestingly. If any appear, ask whether the logical relationship is already clear from sentence order. If yes, delete the transition. If no, replace with the actual relationship (but, because, so, despite, after).

Structural Monotony

Every paragraph follows the same template: topic sentence, three supporting points of equal weight, summary sentence. Real academic writing varies its rhythm.

AI patternHuman pattern
[Topic sentence]. [Point A]. [Point B]. [Point C]. [Summary sentence]. [Repeat for next paragraph.]A short paragraph making one sharp claim. Then a longer passage that develops an argument across six or seven sentences, weaving evidence with interpretation. Then two sentences that pivot to a complication.

Diagnostic: map paragraph lengths across a section. If more than three consecutive paragraphs fall within 10 words of each other, restructure. Vary paragraph length by at least 30%. Mix single-claim paragraphs with multi-sentence analytical passages.

Abstraction Fog

Categories and generalities where specifics belong.

AI patternHuman pattern
Various studies have explored this topic using different methodologies.Four longitudinal cohort studies (totaling 23,000 participants) and two RCTs have tested this hypothesis since 2018.
This has important implications for the field.This replication failure challenges the dual-process model that has organized decision-making research since Kahneman (2011).
Researchers have investigated this phenomenon in multiple contexts.Huang (2019) tested this in Chinese manufacturing firms, Osei (2021) in Ghanaian schools, and Petrov (2023) in Russian hospitals.

Diagnostic: search for "various," "different," "multiple," "numerous," "important," "significant" (non-statistical), "the field," "the literature." Each one is a prompt to substitute a specific name, number, or concrete referent.

Voice Erasure

The writer disappears behind passive constructions and impersonal phrases, even when the discipline expects authorial presence.

AI patternHuman pattern
It can be argued that this framework is insufficient.We argue this framework is insufficient.
The data were analyzed using thematic analysis.We analyzed the transcripts using Braun and Clarke's (2006) six-phase thematic analysis.
It is suggested that future research should examine this.Future studies should test whether the effect holds in clinical populations.

Diagnostic: count instances of "it can be," "it is suggested," "it was found," "it should be noted." Replace each with the actual agent performing the action. In the sciences and social sciences, first person plural is standard. In the humanities, first person singular. Know the convention for the target discipline.

2. Discipline-Aware Register

Academic writing conventions vary by field. Adjust register to the target discipline.

  • Sciences (STEM): Concise, method-focused, passive voice acceptable for methods sections, active voice for argumentation. Numbered hypotheses. Statistical reporting follows APA or field-specific standards.
  • Social Sciences: Balance of active and passive voice. First person plural standard. Theoretical framing expected in introductions. Effect sizes alongside p-values.
  • Humanities: First person singular common. Longer analytical paragraphs. Close reading and interpretive argument valued. Direct engagement with other scholars' positions.
  • Interdisciplinary: Default to active voice with first person plural. Define terms from each contributing field. Bridge jargon gaps explicitly.
Show full SKILL.md (581 more words)Show less

3. Citation Integration

How sources enter sentences matters as much as which sources you cite.

  • Narrative citation when the author's identity matters: "Foucault (1975) argued that..."
  • Parenthetical citation when the finding matters more than who found it: "Incarceration rates tripled between 1980 and 2000 (Alexander, 2010)."
  • Direct quotation only when the original wording is the point: a key definition, a contested phrase, a striking formulation. Never quote to avoid paraphrasing.
  • Synthesis citation to show consensus or disagreement: "Several studies confirm this pattern (Lee, 2019; Nakamura, 2020; dos Santos, 2021), though one found no effect in adolescents (Byrne, 2022)."
</competencies>
<protocol>

When producing any research prose, follow this sequence:

  1. Identify the discipline and audience. Adjust register, citation style, and voice conventions accordingly.
  2. Draft with specificity. Name studies, methods, sample sizes, years. Replace every "various studies" and "the literature suggests" with concrete referents during drafting, not after.
  3. Vary structure deliberately. Before writing each paragraph, choose its shape: single-claim, multi-evidence analytical, pivot-to-complication, or narrative-of-debate. Do not repeat the same shape for three consecutive paragraphs.
  4. Use transitions only for actual logical relationships. If deleting a transition word doesn't change the meaning, delete it.
  5. Self-audit before presenting. Run these five checks against the completed draft:
Self-Audit Checklist
  • Hedging: Fewer than two hedging words per paragraph. Every uncertainty is expressed through evidence ("3 of 5 studies") not through stacked qualifiers.
  • Transitions: Zero instances of Furthermore/Moreover/Additionally/It is important to note. Every remaining transition expresses contrast, cause, consequence, or concession.
  • Structure: No three consecutive paragraphs within 10 words of each other in length. At least two different paragraph shapes per section.
  • Specificity: Zero instances of "various studies," "the literature," "multiple contexts," "important implications" without a concrete referent following within the same sentence.
  • Voice: Fewer than three instances of "it can be," "it is suggested," "it was found" per page. First person used where discipline permits.
  • Citations verified: If the draft cites scholarly sources, write them to a file (one per line or JSON) and run uv run <literature-review-dir>/scripts/verify_citations.py --input refs.txt. Exit 0 required — any mismatched or not_found citation is corrected or removed before presenting. Never present prose containing a citation the verifier could not resolve.
  • Claims traced: If the draft attributes findings or context to scholarly sources present in a review workspace, including abstract-only sources, save the completed draft at $DRAFT and write a non-empty claims.json. Every evidence or background entry contains claim, paper_id, citation (one Author, year or [n] identity), and a verbatim supporting_quote; a claim citing two sources needs two entries. Confirm corpus.json contains trusted authors, year, and role metadata. Run uv run <literature-review-dir>/scripts/check_claims.py --claims claims.json --workspace "$WS" --synthesis "$DRAFT". For numeric citations, first verify the ordered bibliography and add --references refs.json. Exit 0 is required. Resolve every needs_review by reading the reported span. An invalid_binding means the citation did not resolve to exactly one trusted corpus record; use its reason_code to fix metadata or the citation, rather than retrying quote matching. Background entries may cover number-free context only, and every non-year number in a cited synthesis sentence must appear in verified matching claims for each cited identity.

If any check fails, revise before presenting the output.

</protocol>
<complementary>
For general prose mechanics (active voice, positive form, concision, sentence rhythm, subject-verb proximity), the clarity-and-grace plugin provides comprehensive rules from Strunk's Elements of Style and Williams' Style: Lessons in Clarity and Grace. This skill focuses on academic-specific patterns that general prose guides do not cover. The two complement each other without overlap.
</complementary>

© poemswe, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/academic-writing of poemswe/co-researcher.

Open the folder on GitHubat commit 6c6036b

Compare with similar skills

Academic Writing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Academic Writing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Academic Writing this skillpoemswe/co-researcher130—~2.8kAutomated safety check: PassMIT
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence
Academic Research PipelineImbad0202/academic-research-skills51k—~15kAutomated safety check: PassCustom licence
Academic Research Suite for CodexImbad0202/academic-research-skills-codex12k—~12kAutomated safety check: PassCustom licence
Econ Writehanlulong/econ-writing-skill6512 repos~14kAutomated safety check: PassMIT
Autonomous Researchfedericodeponte/opendraft507—~8.2kAutomated safety check: PassApache-2.0

Similar skills

  • Academic Paper Writing Pipeline

    Imbad0202/academic-research-skills

    Runs a 12-agent pipeline that plans, drafts, cites, reviews and formats academic papers, with modes for revision, rebuttals, abstracts and citation checks.

    51k GitHub stars~16k tokensUpdated today
    Research & ScienceAuto-check passed
  • Academic Research Pipeline

    Imbad0202/academic-research-skills

    Orchestrates a ten-stage academic workflow from research to finished manuscript, including integrity checks, two rounds of peer review and revision.

    51k GitHub stars~15k tokensUpdated today
    Research & ScienceAuto-check passed
  • Academic Research Suite for Codex

    Imbad0202/academic-research-skills-codex

    A router skill that sends academic work such as literature reviews, drafting, citation checks, peer review and revision to the right workflow in the ARS suite.

    12k GitHub stars~12k tokensUpdated 7 days ago
    Research & ScienceAuto-check passed
  • Econ Write

    hanlulong/econ-writing-skill

    Expert economics paper writing assistant synthesizing advice from 50+ top guides by Cochrane, McCloskey, Shapiro, Head, Bellemare, Goldin, Glaeser, Kremer, and other leading economists.

    651 GitHub starsUsed in 2 repos~14k tokens
    Research & ScienceAuto-check passed
  • Autonomous Research

    federicodeponte/opendraft

    An 18-agent pipeline that turns one topic line into a drafted research paper, literature review, or thesis chapter.

    507 GitHub stars~8.2k tokensUpdated 9 days ago
    Research & ScienceAuto-check passed
  • Social Science Paper Writing

    fakerqwq/social-science-paper-writing-skill

    Helps draft, diagnose, review and revise social science papers, from topic and research question to literature review, citation risks and pre-submission checks.

    382 GitHub stars~7k tokensUpdated 4 mo ago
    Research & ScienceAuto-check passed

More from poemswe/co-researcher

All 15 skills in this repo
  • Literature Review

    poemswe/co-researcher

    You must use this when synthesizing existing knowledge, identifying research gaps, or tracing the evolution of scientific ideas.

    130 GitHub stars~6k tokensUpdated today
    Auto-check: notes
  • Research Manager

    poemswe/co-researcher

    Use this when starting a new research project or managing a complex, multi-step research workflow.

    130 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Critical Analysis

    poemswe/co-researcher

    You must use this when analyzing claims, evaluating evidence, or Identifying logical fallacies in research.

    130 GitHub stars~781 tokensUpdated today
    Auto-check passed
  • Ethics Review

    poemswe/co-researcher

    You must use this when identifying ethical risks, ensuring participant privacy, or preparing IRB applications.

    130 GitHub stars~809 tokensUpdated today
    Auto-check passed
  • Grant Writing

    poemswe/co-researcher

    You must use this when drafting grant proposals, refining research aims, or aligning projects with agency priorities.

    130 GitHub stars~815 tokensUpdated today
    Auto-check passed
  • Hypothesis Testing

    poemswe/co-researcher

    You must use this when formulating testable hypotheses, designing experimental controls, or defining falsification criteria.

    130 GitHub stars~830 tokensUpdated today
    Auto-check passed

Questions about Academic Writing

What does Academic Writing do?

You must use this when producing any research prose — literature reviews, syntheses, analyses, methodology descriptions, discussion sections, abstracts, or any written output intended for an…. Academic Writing is an agent skill from poemswe/co-researcher. You must use this when producing any research prose — literature reviews, syntheses, analyses, methodology descriptions, discussion sections, abstracts, or any written output intended for an academic audience.

When should I use Academic Writing?

Academic Writing fits situations like: tasks that involve Literature review; tasks that involve Scientific writing.

How do I install Academic Writing in Claude Code?

Run `npx skills add poemswe/co-researcher --skill academic-writing -a claude-code`. Or copy the skill folder (skills/academic-writing in poemswe/co-researcher) into .claude/skills/academic-writing in your project. Claude Code loads it when a task matches its description.

How do I install Academic Writing in Codex?

Run `npx skills add poemswe/co-researcher --skill academic-writing -a codex`. Or copy the skill folder (skills/academic-writing in poemswe/co-researcher) into .agents/skills/academic-writing in your project. Codex loads it when a task matches its description.

Can I use Academic Writing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add poemswe/co-researcher --skill academic-writing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/academic-writing, .gemini/skills/academic-writing, .github/skills/academic-writing and .opencode/skills/academic-writing in your project.

What does Academic Writing need to run?

Going by SKILL.md and its folder, Academic Writing needs the command-line tools its instructions call (uv).

Does Academic Writing access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Academic Writing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Academic Writing use?

Academic Writing is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Academic Writing use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Academic Writing?

Skills that share tags, products or a category with Academic Writing: Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars), Academic Research Pipeline (Imbad0202/academic-research-skills, 51k stars), Academic Research Suite for Codex (Imbad0202/academic-research-skills-codex, 12k stars) and Econ Write (hanlulong/econ-writing-skill, 651 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Academic Writing?

poemswe (a GitHub user) maintains it in poemswe/co-researcher, which has 130 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 11, 2026.

Source: poemswe/co-researcher on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.