/document-skills

Generate or update documentation for all Claude skills across sandbox-answers, CLD, and Spines in the tq-api-docs repo.

Usage

/document-skills [skill-name]

The argument is optional. Omit it to document all skills at once. Pass a skill name (e.g. add-network) to update just that one page.

Before writing any files, the skill prepares the tq-api-docs repo:

Checks for uncommitted changes — stops if any are found.
Fetches, checks out, and pulls main — ensures you're branching from the latest upstream state.
Creates a new branch — docs/sandbox-skills/<skill-name> for a single skill, or docs/sandbox-skills/update-all when documenting all.

Then it scans four skill source directories:

Source	Path
sandbox-answers	`.claude/skills/`
CLD top-level	`airflow_dags/dags/data_science/cld/.claude/skills/`
CLD sub-DAG	`airflow_dags/dags/data_science/cld/core_licensable_data_sub_dag/.claude/skills/`
Spines	`airflow_dags/dags/data_science/spines/.claude/skills/`

For each skill found:

Extracts the skill name, description, and argument hint from SKILL.md frontmatter.
Reads reference.md if present.
Classifies the skill as Question Answering or DAG Editing.
Writes a user-facing doc page to the appropriate subdirectory under sandbox/docs/misc/claude/sandbox_skills/.
Adds the doc's sidebar path to sidebars.ts if not already present.

Skips document-skills and duplicate trino-query skills in CLD/Spines.

tq-api-docs/sandbox/docs/misc/claude/sandbox_skills/question_answering/<skill>.md — Q&A skill doc pages
tq-api-docs/sandbox/docs/misc/claude/sandbox_skills/dag_editing/<skill>.md — editing skill doc pages
tq-api-docs/sandbox/docs/misc/claude/sandbox_skills/index.md — overview page
tq-api-docs/sandbox/sidebars.ts — sidebar entries

Run /document-skills after:

Pass a skill name as an argument to update just one page without touching the others.