Claude Code Plugins

Community-maintained marketplace

Feedback

academic-writing-standards

@seabbs/claude-code-config
5
0

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.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

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.