How snl-ucsb/paper-writing-skill works
This repository is a Claude Code skill and reusable set of Markdown methods for research-paper writing, not a conventional application. A researcher invokes the skill, creates or reuses a project context, then develops and refines a paper through the documented pipeline. The graph preserves the alternate story-mode entry, editorial gates and iterative red-team loop, plus the separate figure-synthesis workflow and customizable rules. Relationships are based on the README; source excerpts were not provided, so implementation-level calls cannot be verified.
Main entry points: SKILL.md Section drafting · red_team_protocol.md Red team · figure_synthesis_guide.md Figure workflow · loop_mode.md Audit loop
Components 23
Paper workflow
- Skill entry
SKILL.md - Story mode
story_mode.md - Brainstorming
brainstorming_guide.md - Project context
examples/project_context.md - Paper architecture
SKILL.md - Section drafting
SKILL.md - Integration
SKILL.md - Compression
author_profile/compression_patterns.md
Editorial quality
- Mechanical gate
author_profile/gate_mechanical.md - Semantic gate
author_profile/gate_semantic.md - Craft reference
author_profile/craft_reference.md - Red team
red_team_protocol.md - Audit loop
loop_mode.md
Figure synthesis
- Figure workflow
figure_synthesis_guide.md - Figure templates
figure_templates/figure_spec_template.md
Rules and guidance
- Editorial principles
author_profile/editorial_principles.md - Rhetorical moves
author_profile/rhetorical_moves.md - Section move guides
section_rhetorical_moves/introduction.md - Writing checklists
writing_checklists/intro_questions.md - Intervention types
author_profile/intervention_types.md
Other components
- Researcher
- Claude Code
- Viz skill
Connections 25
- Researcher → Claude Code: invokes skill
README.md - Claude Code → Skill entry: loads
README.md - Researcher → Story mode: supplies existing record
README.md - Researcher → Brainstorming: answers questions
README.md - Brainstorming → Project context: produces context
README.md - Story mode → Paper architecture: develops story and outline
README.md - Project context → Paper architecture: guides planning
README.md - Paper architecture → Section drafting: plans sections
README.md - Section drafting → Integration: feeds drafts
README.md - Integration → Compression: precedes reduction
README.md - Section drafting → Mechanical gate: audits every edit
README.md - Red team → Semantic gate: applies gate
README.md - Red team → Mechanical gate: reruns greps
README.md - Researcher → Red team: requests independent review
README.md - Audit loop → Red team: iterates audit
README.md - Audit loop → Section drafting: iterates fixes
README.md - Section drafting → Craft reference: uses writing guidance
README.md - Figure workflow → Figure templates: uses templates
README.md - Researcher → Figure workflow: requests figure synthesis
README.md - Viz skill → Figure workflow: handles data plots separately
README.md - Section drafting → Rhetorical moves: uses move sequences
README.md - Section drafting → Section move guides: uses section guidance
README.md - Section drafting → Writing checklists: checks drafts
README.md - Researcher → Intervention types: requests feedback
README.md - Researcher → Editorial principles: customizes rules
README.md