Internal Standards

---
name: internal-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 `markdown.md`. Read it directly.
---

# Standards

Read `.claude/context/standards/overview.md` for the system overview and `.claude/context/standards/resolution.md` for how a standard reaches a reader before editing.

## Prose rules

Read `standards/markdown.md` and load the `write-human` skill before writing or editing any prose in `standards/` or `docs/`. The first is the canonical reference for banned words, spellings, formatting, and punctuation. The second carries voice, rhythm, and sentence construction, which no check settles.

## 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/overview.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/index.md`: the domain catalog, with the overview, the scope model, authoring, and resolution as sub-areas
- `standards/markdown.md`: heading, list, code, punctuation, file-reference, banned-word, and frontmatter wording rules
- The `write-human` skill: voice, rhythm, sentence construction, and information density
- `standards/standard.md`: the meta-standard for a standard's shape, scope, and frontmatter