Standards and Documentation System

Guidance for editing standards and docs files, covering authoring conventions, install/sync, and cross-referencing rules.

Sby Skills Guide Bot
DocumentationIntermediate
108/3/2026
Claude Code
#standards#documentation#conventions#sync#prose

Recommended for


name: aitk-standards description: Standards system and docs. Use when editing files in standards/ or docs/, including authoring conventions, install, and sync. Do not load this skill to read prose.md. Read it directly.

Standards

Read .claude/context/standards.md for system overview and install vs sync before editing.

Prose rules

Read .claude/standards/prose.md before writing or editing any prose in standards/ or docs/. It is the canonical voice and formatting reference.

Cross-references

  • Do not reference one standard from another. Standards are loaded simultaneously by skills, so signpost links between them add noise without value.
  • A functional cross-reference that changes behavior is allowed (for example, telling the reader which sibling standard still applies when a hook would otherwise skip the content). Bare signposts are not.

Sync checklist

When adding a standard:

  • Create the .md file in standards/ following standards/standard.md for shape, frontmatter, and structure.
  • Update the standards table in .claude/context/standards.md
  • Do not hand-edit standards/index.md. It is generated by scripts/core/regen-indexes.sh (runs as part of bun run check), and it fails if any standard is missing required frontmatter.

Reference

  • .claude/context/standards.md: system overview, install vs sync, adding standards
  • .claude/standards/prose.md: full voice, structure, formatting, and language rules
  • .claude/standards/standard.md: the meta-standard for a standard's shape, scope, and frontmatter
Related skills