# Crimson Leaf Publishing — Skills Catalog

Skills are context-sensitive reference documents injected into an agent's prompt
when a template declares a `skills:` array. They provide craft knowledge without
permanently inflating RAG storage.

## Available Guides

| Path | Purpose | Used by |
|------|---------|---------|
| `guides/YAFictionGuide.md` | YA genre conventions, voice rules, tropes, audience sensitivities | `book_chapter` (when genre is YA — apply only this guide) |
| `guides/RomanceFictionGuide.md` | Romance beats, HEA/HFN requirement, sub-genre map, tension escalation | `book_chapter` (when genre is Romance — apply only this guide) |
| `guides/SciFiFictionGuide.md` | World-building discipline, tech credibility, sub-genre map, pacing | `book_chapter` (when genre is Sci-Fi — apply only this guide) |
| `guides/BlogWritingGuide.md` | Blog structure, hook styles, CTA patterns, voice rules | `blog_write`, `blog_research` |
| `guides/RecipeWritingGuide.md` | Recipe format, headnote style, ingredient conventions, method voice | `recipe_develop`, `recipe_collection_plan` |

## Writing vs Editorial Guide Rules (Sprint 56)

**Writing templates** (`book_outline`, `book_chapter`, `short_story`) receive genre-appropriate
craft guides. All three fiction guides are currently injected into `book_chapter` so it can
serve any fiction genre — the template instructs the agent to apply ONLY the guide matching
`{genre_name}` and ignore the others.

**Editorial templates** (`chapter_review`, `chapter_roundtable`, `chapter_polish`) do NOT
receive writing-craft guides. Writing-style guidance injected into editorial tasks creates
conflicting signals and can trigger unintended prose rewriting. Editorial agents rely on
their own domain expertise and the chapter text itself.

This boundary was established in Sprint 56 to prevent conflicting craft signals and reduce
downstream voice drift.

## How Skills Work

1. A template declares `skills: ["guides/YAFictionGuide.md"]` at the top level.
2. At prompt assembly time, the pipeline fetches each file from `pae/crimson_leaf_publishing/skills/{path}`.
3. Content is injected as the `*** SKILLS & GUIDES ***` section in the agent's prompt.
4. The agent reads the guide as authoritative reference material for the current task.

## Adding a New Skill Guide

1. Create the file in `guides/`
2. Add an entry to this table
3. Reference the path in the relevant template's `skills:` array
4. Follow the writing-vs-editorial boundary rule above: writing guides belong only in
   writing templates; editorial templates should not inject writing-craft guides
