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
.mdfile instandards/followingstandards/standard.mdfor shape, frontmatter, and structure. - Update the standards table in
.claude/context/standards.md - Do not hand-edit
standards/index.md. It is generated byscripts/core/regen-indexes.sh(runs as part ofbun 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
API Documentation Generator
Documentation
Automatically generates OpenAPI/Swagger API documentation.
Technical Writer
Documentation
Writes clear technical documentation following top style guides.
Architecture Decision Tracking
Documentation
Manages Architecture Decision Records (ADRs) using Michael Nygard's format: auto-numbered creation, search, index updates, and superseding workflows. Helps when documenting architectural decisions, tracking rationale, or managing ADR lifecycle (proposed, accepted, deprecated, superseded).