Imported from 4riel/docko (
.agents/skills/docko-docs/SKILL.md). Install upstream withnpx skills add 4riel/docko --skill docko-docs. Copyright stays with the author.
docko Docs
Rules for editing docko's documentation set. Use it before changing any prose surface in this repo.
Read first
docs/development.mddocs/INDEX.mdREADME.md- The specific guide or example you are changing
Writing rules
- Treat protocol docs and schemas as the source of truth.
- Do not create a second truth system for command behavior or runtime semantics.
- Distinguish clearly between implemented behavior, recommended usage, and roadmap material.
- Confirm commands, file paths, and runtime claims in source, templates, or tests before documenting them.
- Keep examples short, copy-pastable, and shell-neutral.
- Update indexes and contributor-facing docs when adding new guides.
- Label runtime examples clearly as one of: shipped Claude Code asset or manual Codex guidance.
- Do not present non-Claude runtimes as implemented runtime adapters unless matching packages, templates, and tests exist.
Verify
- Re-read every changed doc against the implementation.
- Run
pnpm buildorpnpm testwhen the documentation depends on command behavior that changed. - Call out any unverified command examples or environment-specific assumptions.