Audit a project against current plugin conventions and offer to update structure.
View on GitHubhowells/fiction
fiction
skills/reconcile/SKILL.md
January 25, 2026
Select agents to install to:
npx add-skill https://github.com/howells/fiction/blob/main/skills/reconcile/SKILL.md -a claude-code --skill reconcileInstallation paths:
.claude/skills/reconcile/Reconcile an existing fiction project with the current plugin conventions. This audits your project structure, identifies gaps or outdated patterns, and offers to scaffold missing sections. Use this when: - You've updated the fiction plugin and want to adopt new conventions - You've been working on a project and want to ensure it follows best practices - You're inheriting a project and want to understand what's missing ## What to Do ### 1. Find Project Root Same as `/load` — look for README.md, chapters/, characters/ directories. ### 2. Audit Structure Check for expected directories and files: **Required:** - [ ] `README.md` — Project overview - [ ] `chapters/` — Chapter files **Recommended:** - [ ] `characters/` — Character documents - [ ] `world/` — World/setting documents - [ ] `craft/tone.md` — Voice guidance - [ ] `themes.md` — Thematic content **Build & Cover:** - [ ] `builds/` — EPUB build outputs (date-organized) - [ ] `covers/` — Cover artwork iterations - [ ] `critiques/` — Critique outputs (date-organized) - [ ] `synopses/` — Synopsis outputs (date-organized) - [ ] `epub.css` — EPUB styling (if building) ### 3. Audit File Content For each existing file, check for expected sections: **README.md should have:** - [ ] `## Anchored` — Immutable constraints (new convention) - [ ] `## Key Decisions` — Tracked decisions - [ ] `## Status` — Project status - [ ] `## Chapters` — Chapter list **Character files should have:** - [ ] Want vs. Need - [ ] Lie / Ghost / Flaw (for major characters) - [ ] Voice notes **For series projects, also check:** - [ ] `series-architecture.md` with `## Anchored` section - [ ] Book-level anchors that reference series anchors ### 4. Generate Report Output a reconciliation report: ```markdown ## Reconciliation Report: [Project Name] ### Structure Status - README.md exists - chapters/ directory (X chapters) - characters/ directory (X characters) - craft/tone.md — missing - themes.md exists - builds/ — missing (create wit