State Convention — Development skill for Claude Code
Paper State Convention.
How to install State Convention
Installs to ~/.claude/skills/ripemangobox-researchflow-state_convention/SKILL.md
mkdir -p ~/.claude/skills/ripemangobox-researchflow-state_convention && curl -fsSL https://raw.githubusercontent.com/RipeMangoBox/ResearchFlow/HEAD/.claude/skills/STATE_CONVENTION.md -o ~/.claude/skills/ripemangobox-researchflow-state_convention/SKILL.md Restart Claude Code, or start a new session, for it to be picked up.
What State Convention does
Paper State Convention
Unified definitions for the `state` column in `paper_list.csv`. All skills must follow this convention.
State flow
Wait → Downloaded → analysised → checked
│ │
│ ├→ too_large (PDF cannot be parsed within local limits)
│ └→ analysis_mismatch (analysis/export validation failed)
│
├→ Skip (user manually excluded)
└→ Missing (download failed, PDF unavailable)
Main pipeline states
| state | Meaning | Written b
Alternatives in Development
- Friction Protocol — Friction protocol — convention 29.1k ★
- PaperSpine — PaperSpine is a motivation-driven skill for learning from strong academic papers, building a paper’s central a 5k ★
- Ars Abstract — ARS academic-paper abstract-only mode — bilingual abstract + keywords 4.5k ★
Full documentation available on GitHub
View Source RepositoryRelated Skills
Paper Trail Cascade
Acquire PDFs via the 8-source cascade (11 with opt-in extended sources) for a single ref by slug, or a batch f
Paper Trail Decide
Inspect a single reference in detail (identity, PDF status, acquisition history with verdicts, citation contex
Create Agent Plan
Analyzes tickets and creates convention-compliant implementation plans with gap identification and research co
Think First Principles
Reason from fundamentals by decomposing a problem to its irreducible level, then stripping the inherited assum
Create ADR
Record an architecture decision with rigorous alternatives analysis and honest consequences. For high-switchin
New Element
Add a new ArchLang element via the registry convention
Related Agents
Convention Auditor
Audits codebase for convention violations including naming, logging, configuration, imports, and error handlin
Convention Eval
Backend Convention Checker
Use this agent when a plan file's lint verification stage needs to be executed — specifically to check recentl