Document Structure
Skill id:
document-structure
Generated from JSON Schema — do not edit by hand. Run bun run cat-harness/scripts/gen-schema-docs.ts.
Input
Input schema for the document-structure skill: add, remove or reorder chapters and sections.
| Field | Type | Required | Description |
|---|---|---|---|
document | string | yes | Document slug under content/. |
operation | "add-chapter" | "add-section" | "reorder-chapters" | "reorder-sections" | yes | Structural change to make. Reordering edits the manifest only — directories are never renamed, because labels, uses[], feedback and QA sidecars all key on names. |
chapter | string | no | Chapter directory name. Required for every operation except reorder-chapters. |
title | string | no | Human-readable title, for the add-* operations. |
position | integer | no | Zero-based index to insert at. Appends when omitted. |
order | array | no | The complete new order, for the reorder-* operations. Must be a permutation of the existing entries. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
manifestsChanged | array | yes | |
chapters | array | no | Chapter directory names in their new reading order. |
forwardReferences | array | no | Labels whose uses[] now points forward in reading order. A real finding after a reorder, not a mechanical detail. |