generate-docs

Generate and Verify Component Documentation

Run the complete component-documentation workflow in the current task. The workflow must not depend on lifecycle hooks, transcript inspection, completion promises, or host-specific environment variables. Use whichever native fresh-session delegation capability the host exposes for independent verification.

Bundled workflows

Before starting, read both sibling skills completely, resolving these paths relative to this SKILL.md:

• component-docs
• review-docs

Do not invoke them through host-specific slash-command syntax. Apply their instructions directly within this task.

Arguments

• PATH: positional skill argument for the component repository; default to the current working directory at invocation time. This is not the shell PATH environment variable; never assign to or export the shell PATH variable.
• --max-iterations N: maximum review/fix passes; default 5. Require a positive integer.
• --review or --skip-generate: review and fix existing documentation without running component-document generation.
• --cache-dir DIR: shared review cache; default to a new run directory under REPO_PATH/.work/agentic-docs/.
• --keep-cache: keep the cache after a successful run instead of deleting it.
• -h or --help: report usage and options without changing files.

Reject unexpected arguments before changing files. Resolve the PATH argument exactly once to an absolute, canonical directory, store it in REPO_PATH, and confirm it exists and is a directory.

Use REPO_PATH as the target for the entire workflow: either set every repository operation's working directory to REPO_PATH or use absolute paths rooted at REPO_PATH. Do not use relative repository paths after this point.

Independent verification

Each verification pass must use a fresh, general-purpose isolated reviewer that has not participated in generating or fixing the documentation. Never resume or reuse a reviewer from an earlier pass.