Sandbox
@lishix520/academic-paper-skills

Claude Code skills for academic paper planning and writing

This repo packages two Claude Code skills: one for planning a paper and one for writing it. The strategist skill helps you analyze venues, build a literature-backed gap, and produce an outline; the composer skill turns that outline into a draft with quality checks and final review.

1,279 stars138 forksPythonUpdated 8mo ago
Who it's for

Builders who use Claude Code to plan and write philosophy or interdisciplinary papers.

What it delivers

You can move from a research idea to a checked manuscript without reworking your structure and standards each time.

What it does

Two-step paper workflow

Uses a strategist skill for planning and a composer skill for drafting, so you can move from outline to manuscript in stages.

Evidence-backed gap finding

Requires each research gap to be supported by 3–5 citations before the outline moves forward.

Style learning from sample papers

Analyzes 8–10 sample papers to extract venue-specific writing standards.

Reviewer simulation

Scores outlines across seven dimensions with a 35-point review model before writing begins.

Quality gates and checks

Adds three validation gates and two Python verification scripts to catch weak outlines and draft issues.

Preprint support

Includes workflows aimed at PhilArchive, arXiv, PhilSci-Archive, PsyArXiv, and similar venues.

How to get it

  1. 1Clone this repository
    git clone https://github.com/yourusername/academic-paper-skills.git
  2. 2Copy skills to your Claude Code skills directory
    cp -r strategist ~/.claude/skills/academic-paper-strategist
    cp -r composer ~/.claude/skills/academic-paper-composer
  3. 3Run
    You: Plan a paper on how mortality generates consciousness
    
    Claude: [Activates academic-paper-strategist]
            Let me guide you through the three phases...
  4. 4Run
    You: Write the paper from this outline: [your outline]
    
    Claude: [Activates academic-paper-composer]
            Starting Phase 1: Foundation setup...

README

Academic Paper Skills for Claude Code

A systematic framework for planning and writing philosophy and interdisciplinary academic papers using Claude Code. These skills transform your research ideas into submission-ready manuscripts through structured workflows with quality checkpoints.

Features

  • End-to-End Pipeline: From initial idea to polished manuscript
  • Evidence-Based Gap Identification: Every research gap backed by 3-5 citations
  • Platform-Specific Style Learning: Analyze 8-10 sample papers to extract writing standards
  • Reviewer Simulation: 7-dimension, 35-point assessment system
  • Quality Assurance: 3 validation gates + 2 Python verification scripts
  • Preprint Platform Support: PhilArchive, arXiv, PhilSci-Archive, PsyArXiv, and more

Two-Skill Workflow

┌─────────────────────────────────────────────────────────────┐
│                 ACADEMIC-PAPER-STRATEGIST                   │
│  Phase 1: Platform Analysis → Target venue + style guide    │
│  Phase 2: Theoretical Framework → Literature + gap analysis │
│  Phase 3: Outline Optimization → Reviewer-assessed outline  │
└─────────────────────────┬───────────────────────────────────┘
                          ↓
                   [Detailed Outline]
                          ↓
┌─────────────────────────┴───────────────────────────────────┐
│                  ACADEMIC-PAPER-COMPOSER                    │
│  Phase 1: Foundation → Style guide + chapter planning       │
│  Phase 2: Systematic Writing → Draft with quality checks    │
│  Phase 3: Polish → Final evaluation + submission prep       │
└─────────────────────────────────────────────────────────────┘

Installation

Prerequisites

  • Claude Code installed and configured
  • Python 3.8+ (for verification scripts)

Setup

  1. Clone this repository:
git clone https://github.com/yourusername/academic-paper-skills.git
  1. Copy skills to your Claude Code skills directory:
cp -r strategist ~/.claude/skills/academic-paper-strategist
cp -r composer ~/.claude/skills/academic-paper-composer
  1. Restart Claude Code to load the skills.

Quick Start

Planning a Paper (Strategist)

You: Plan a paper on how mortality generates consciousness

Claude: [Activates academic-paper-strategist]
        Let me guide you through the three phases...

Writing from Outline (Composer)

You: Write the paper from this outline: [your outline]

Claude: [Activates academic-paper-composer]
        Starting Phase 1: Foundation setup...

Directory Structure

academic-paper-skills/
├── strategist/
│   ├── SKILL.md                    # Main skill definition
│   ├── references/
│   │   ├── quality_standards.md    # Evaluation criteria
│   │   └── search_strategy.md      # Literature search guide
│   └── scripts/
│       ├── evaluate_samples.py     # Sample paper analyzer
│       └── gap_analysis.py         # Research gap validator
├── composer/
│   ├── SKILL.md                    # Main skill definition
│   ├── references/
│   │   ├── section_guides.md       # Section-by-section guidance
│   │   └── writing_standards.md    # Academic writing principles
│   └── scripts/
│       ├── chapter_quality_check.py    # Per-chapter validation
│       └── final_evaluation.py         # Full manuscript assessment
└── examples/
    ├── consciousness-paper.md      # Example: Philosophy of mind
    └── ai-ethics-paper.md          # Example: AI ethics

Quality Standards

Reviewer Simulation (7 Dimensions)

DimensionWeightCriteria
Originality5 ptsNovel contribution to field
Argumentation5 ptsLogical coherence, evidence support
Literature5 ptsComprehensive, current coverage
Methodology5 ptsAppropriate, rigorous approach
Clarity5 ptsAccessible, well-structured writing
Impact5 ptsPotential influence on field
Technical5 ptsAccuracy, proper citations

Threshold: Outlines scoring ≥28/35 proceed to writing phase.

Use Cases

  • PhD students: Transform dissertation chapters into publishable papers
  • Independent researchers: Professional-grade paper planning without institutional support
  • Interdisciplinary work: Navigate multiple platform requirements
  • Preprint submission: Prepare manuscripts for PhilArchive, arXiv, etc.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.

Author

Li Shixiong Independent Researcher ORCID: 0009-0008-2001-2865


These skills were developed through the author's experience publishing philosophy papers on consciousness and mortality.

Files in the repo

Repository payload7 top-level entries
  • composer
  • examples
  • strategist
  • CONTRIBUTING.md
  • LICENSE
  • README_CN.md
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k

Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.

57k
ayghri/
i-have-adhd

A skill to stop your coding agent from burying the answer. ADHD-friendly output.

38k