---
name: Chapter Skeleton
slug: chapter-skeleton
category: Writing
description: Chapter Skeleton builds a retrieval-informed chapter outline from taxonomy and scope before detailed subsection decomposition. Use it when chapter-level structure should be stabilized first.
github: "https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/chapter-skeleton"
language: Python
stars: 499
forks: 39
install: "npx degit https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/chapter-skeleton ~/.claude/skills/chapter-skeleton"
installs_to: ~/.claude/skills/chapter-skeleton
source_path: .codex/skills/chapter-skeleton/SKILL.md
collection_size: 25
category_size: 1012
collection_url: "https://dirskills.com/collections/WILLOSCAR/research-units-pipeline-skills"
added: 2026-08-26T05:12:52.803Z
last_synced: 2026-08-26T05:12:52.803Z
canonical_url: "https://dirskills.com/skills/chapter-skeleton"
---

# Chapter Skeleton

Chapter Skeleton builds a retrieval-informed chapter outline from taxonomy and scope before detailed subsection decomposition. Use it when chapter-level structure should be stabilized first.

**Install:**

```bash
npx degit https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/chapter-skeleton ~/.claude/skills/chapter-skeleton
```

## README

# Chapter Skeleton

## Explicit refinement marker

Create `outline/chapter_skeleton.refined.ok` only after reviewing a manually refined skeleton. A changed taxonomy, goal, or generator invalidates the marker; reruns then back up and rebuild the skeleton.

## Load Order

Always read:
- `references/overview.md`

Use `scripts/run.py` only for deterministic materialization:
- read `outline/taxonomy.yml` for retrieval-informed topic structure
- read `GOAL.md` when present for scope hints
- emit `outline/chapter_skeleton.yml`
- preserve reviewed user work only through the current explicit refinement marker

## Inputs

- `outline/taxonomy.yml`
- Optional: `GOAL.md`

## Outputs

- `outline/chapter_skeleton.yml`

## Asset contract

- `assets/output_contract.json`

## Script

### Quick Start

- `uv run python .codex/skills/chapter-skeleton/scripts/run.py --workspace <workspace>`

### All Options

- `--workspace <dir>`: workspace containing `outline/taxonomy.yml`
- `--unit-id <id>`: optional harness metadata
- `--inputs <semicolon-separated>`: optional override from `UNITS.csv`
- `--outputs <semicolon-separated>`: optional output override; default is `outline/chapter_skeleton.yml`
- `--checkpoint <C*>`: optional harness metadata

### Examples

- Generate the chapter skeleton after taxonomy:
  - `uv run python .codex/skills/chapter-skeleton/scripts/run.py --workspace <workspace> --inputs 'outline/taxonomy.yml;GOAL.md' --outputs 'outline/chapter_skeleton.yml'`