academic-writing-standards — Claude Code skill: how to install
The academic-writing-standards Claude Code skill guides scientific manuscript editing, including Pandoc citation checks and bibliography cross-referencing.
MIT 130 installs ★ 6 updated 2026-08-25
npx skills add seabbs/skills --skill academic-writing-standards -a claude-codeWhat academic-writing-standards does
This skill guides the assistant through editing research drafts. It pushes for direct sentences and active verbs instead of vague qualifiers. Formatting rules enforce UK spelling and limit lines to 80 characters.
The instructions cover citation checks for Pandoc syntax like [@author2024] and bibliography cross-referencing. The assistant spots unresolved placeholders, syntax errors in keys, and references missing from your .bib collection.
Domain conventions are included for epidemiological phrasing, computational notes, and statistical notation. If a .bib file is missing from the workspace, the skill cannot fully check citations. It flags them for manual review.
What it helps with
- rewrite passive or wordy passages into direct academic prose
- verify Pandoc citations against an existing
.bibbibliography - identify leftover citation placeholders such as
[@TODO]or[@CITE] - enforce line wrapping at 80 characters and UK English conventions
- align statistical intervals and public health terminology with publication norms
Example prompts for the agent
- Review
manuscript.mdagainst academic writing standards and cut bloated phrasing. - Check citations in
paper.mdagainstreferences.biband list missing entries. - Rewrite the discussion section using active voice and UK spelling.
How to install academic-writing-standards
1Skills CLI (Vercel)
npx skills add seabbs/skills --skill academic-writing-standards -a claude-code2Manually: put the files in place
~/.claude/skills/academic-writing-standards/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/academic-writing-standards/
1Skills CLI (Vercel)
npx skills add seabbs/skills --skill academic-writing-standards -a codex2Manually: put the files in place
.agents/skills/academic-writing-standards/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add seabbs/skills --skill academic-writing-standards -a cursor2Manually: put the files in place
.cursor/skills/academic-writing-standards/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install seabbs/skills plugins/research-academic/skills/academic-writing-standards2Manually: put the files in place
.github/skills/academic-writing-standards/SKILL.md1Skills CLI (Vercel)
npx skills add seabbs/skills --skill academic-writing-standards -a gemini-cli2Platform CLI
gemini skills install https://github.com/seabbs/skills --path plugins/research-academic/skills/academic-writing-standardsManually: put the files in place
.devin/skills/academic-writing-standards/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add seabbs/skills --skill academic-writing-standards -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about academic-writing-standards
How do I install academic-writing-standards in Claude Code?
Run npx skills add seabbs/skills --skill academic-writing-standards -a claude-code in your terminal.
What does academic-writing-standards do?
It provides editing conventions for scientific papers, helping your assistant prune unnecessary qualifiers, format Pandoc citations, and verify references.
Does the skill require a .bib file?
No, the skill can edit prose and style without one. However, full reference validation requires a .bib file to match citation keys.
Source text
SKILL.md · MIT
---
name: academic-writing-standards
description: Expert knowledge of academic writing standards for peer-reviewed papers, including citation integrity, style compliance, clarity, and scientific writing best practices. Use when reviewing or editing academic manuscripts, papers, or research documentation.
---
# Academic Writing Standards
This skill provides expertise in academic writing standards for peer-reviewed research papers, ensuring clarity, rigour, and adherence to scientific writing conventions.
## Core Writing Principles
### Clarity and Directness
**Prioritise:**
- Clarity over eloquence
- Precision over persuasion
- Simple constructions over complex ones
- Active voice wherever possible
**Avoid:**
- Unnecessary adjectives and adverbs
- Overstatement and hyperbole
- Excessive qualification ("very", "clearly", "significantly", "novel")
- Complex punctuation where simpler alternatives work
### Style Transformations
**Examples of preferred style:**
```
Wordy: "The results clearly demonstrate that the novel approach significantly outperforms existing methods"
Better: "The approach outperforms existing methods"
Complex: "The model—which incorporates multiple data sources; including case counts, hospitalisations, and genomic data—provides insights"
Better: "The model incorporates case counts, hospitalisations, and genomic data. It provides insights"
Passive: "It was found that the infection rate was increasing"
Active: "We found the infection rate increased"
Hedged: "It appears that the results seem to suggest that there might be a relationship"
Direct: "The results suggest a relationship"
```
### Punctuation Simplification
**Avoid semicolons** when possible:
```
Avoid: "The model includes three components; case counts, delays, and reporting rates"
Better: "The model includes three components: case counts, delays, and reporting rates"
Or: "The model includes three components. These are case counts, delays, and reporting rates"
```
**Avoid excessive em-dashes:**
```
Avoid: "The approach—which we developed over three years—shows promise"
Better: "The approach shows promise. We developed it over three years"
```
**Simplify nested clauses:**
```
Avoid: "The method, which incorporates data from multiple sources, including surveillance systems, which track cases daily, and laboratory reports, provides estimates"
Better: "The method incorporates data from surveillance systems and laboratory reports. It provides estimates"
```
## Formatting Standards
### Document Structure
- **One sentence per line** in markdown format
- **Maximum 80 characters per line**
- **UK English** spelling (favour, colour, modelling, analyse)
- No trailing whitespace
- No spurious blank lines
### Mathematical Notation
- Use proper LaTeX formatting in appropriate contexts
- Define all notation clearly on first use
- Keep mathematical exposition accessible
## Citation and Reference Standards
### Citation Format Checking
**Common formats to verify:**
- Pandoc markdown: `[@author2024]`, `[@author2024; @other2023]`
- Multiple citations: `[@first2024; @second2024]`
- In-text citations: `@author2024 showed that...`
### Reference Integrity
**Check for:**
- Placeholder citations: `[@placeholder]`, `[@TODO]`, `[@CITE]`
- Malformed citations: Missing brackets, typos in citation keys
- Dangling references: Citations in text without corresponding bibliography entries
- Unused references: Bibliography entries never cited
**Citation consistency:**
- Verify citation keys follow consistent naming (e.g., `authorYear`, `author_year`)
- Check citation formatting matches throughout document
- Ensure proper use of et al. in multi-author citations
### Bibliography Verification
**When .bib file available:**
- Cross-reference every citation against bibliography
- Check for missing entries
- Verify citation keys match exactly
- Note any formatting inconsistencies in bibliography
**When .bib file unavailable:**
- Flag that references cannot be fully verified
- Suggest author independently verify all citations
- Check citation formatting consistency in text
## Originality and Attribution
### Identifying Potential Issues
**Flag text that:**
- Uses distinctive phrasing that may be borrowed
- Contains technical descriptions matching common sources
- Includes sequences of concepts in specific order suggesting copying
- Lacks clear paraphrasing when discussing others' work
**Not plagiarism checking:**
- Cannot definitively identify plagiarism
- Flags passages requiring author verification
- Suggests paraphrasing where appropriate
- Encourages proper attribution
### Proper Paraphrasing Guidance
**Poor paraphrasing:**
```
Original: "The model incorporates a hierarchical Bayesian structure with conjugate priors"
Poor: "The approach uses a hierarchical Bayesian framework with conjugate priors"
```
**Good paraphrasing:**
```
Better: "We used Bayesian hierarchical modelling with conjugate prior distributions"
```
## Common Writing Issues
### Overused Qualifiers
**Remove or replace:**
- "clearly", "obviously", "evidently" → Often unnecessary, let evidence speak
- "very", "quite", "rather" → Use stronger base word
- "significantly" → Reserve for statistical significance
- "novel", "new" → Show novelty through comparison, don't claim it
- "state-of-the-art" → Demonstrate through benchmarking
### Vague Language
**Replace with specifics:**
```
Vague: "The model performed well"
Specific: "The model achieved 95% accuracy"
Vague: "We used a large dataset"
Specific: "We used a dataset of 10,000 cases"
Vague: "Results improved substantially"
Specific: "Accuracy improved from 80% to 92%"
```
### Redundancy
**Common redundancies to fix:**
- "past history" → "history"
- "future plans" → "plans"
- "end result" → "result"
- "basic fundamentals" → "fundamentals"
- "completely finished" → "finished"
## Field-Specific Conventions
### Epidemiology and Public Health
- Use "infection" not "case" when referring to true infections
- Distinguish "reported cases" from "infections"
- Use "reproduction number" not "R value" in formal writing
- Define abbreviations on first use: "reproduction number (R)"
### Statistical Reporting
- Report confidence/credible intervals: "estimate (95% CI: lower, upper)"
- Use "uncertainty interval" for Bayesian analyses
- Report p-values accurately: "p < 0.001" not "p = 0.000"
- Distinguish statistical significance from practical importance
### Computational Methods
- Use "implementation" not "coding"
- "Algorithm" for theoretical description, "implementation" for code
- Report computational resources when relevant
- Specify software versions and packages
## Review Structure
When reviewing academic writing, structure feedback as:
1. **Reference Issues**
- Citation formatting problems
- Placeholder citations
- Missing bibliography entries
- Inconsistencies in citation style
2. **Attribution Concerns**
- Passages requiring verification
- Suggestions for better paraphrasing
- Unclear sourcing of ideas
3. **Style Improvements**
- Clarity and conciseness suggestions
- Active voice conversions
- Simplified sentence structures
- Removed unnecessary qualifiers
4. **Formatting Issues**
- Line length violations
- Formatting inconsistencies
- Spelling (UK vs US English)
## When to Apply This Skill
Use these standards when:
- Reviewing academic manuscripts
- Editing research papers
- Preparing submissions to journals
- Writing methods sections
- Drafting discussion sections
- Revising based on reviewer comments
Maintain scientific rigour whilst improving readability.
Always provide specific, actionable feedback with examples.
© seabbs · MIT · seabbs/skills