Back to Skills

reconcile

verified

Audit a project against current plugin conventions and offer to update structure.

View on GitHub

Marketplace

howells-fiction

howells/fiction

Plugin

fiction

Repository

howells/fiction

skills/reconcile/SKILL.md

Last Verified

January 25, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/howells/fiction/blob/main/skills/reconcile/SKILL.md -a claude-code --skill reconcile

Installation paths:

Claude
.claude/skills/reconcile/
Powered by add-skill CLI

Instructions

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

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
4472 chars