Installs into .claude/skills of the current project.
Are you the author of Spec?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/jisundr-spec)
---
name: spec
description: Spec/design doc structure — architecture, components, data flow, errors, testing. Loaded by scribe.
---
# cairn:spec
Write under `docs/`, at a path matching what was asked. Sections, scaled to what's actually decided:
## Architecture
The shape of the solution and why, over the alternatives considered.
## Components
Each piece: what it does, how it's used, what it depends on.
## Data flow
How information moves through the components. A flow with branches, or a layout of several components, gets a diagram per `cairn:diagrams`; one a short list carries stays a list.
## Error handling
What can go wrong and what happens when it does.
## Testing
How the design gets verified.
Omit any section the request hasn't actually resolved yet — an unresolved section stays unwritten, not filled with a placeholder.