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 Records (ADR)
Documentation
This skill helps document and manage architecture decisions using structured ADR templates. It guides users through context, decision drivers, options, and consequences for technical choices. Use it when evaluating new frameworks, database technologies, API designs, or security architecture.