---
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