Menu

Individual skill

spec

0upvotes

Write and keep current the reference documents a team reads long after the work merged: the API contract per resource, the schema per table, the behaviour of a feature, and a screen's components as its Figma design draws them. Also reports where they drift from the code, and a screen from its design. In a contract-first project, writes them from the design before the code exists. Use when a project has no written contract, when a merged change left one behind, or when the contract has to exist before the code. Triggers on: "spec", "api spec", "database spec", "feature spec", "đặc tả", "tài liệu API", "tài liệu database", "spec bị lệch", "cập nhật tài liệu", "仕様書", "API仕様", "spec drift", "document this endpoint", "is the doc still true", "api docs before the code", "contract first", "viết tài liệu API trước khi code", "API docs cho FE làm trước", "実装前にAPI仕様を書く", "screen spec", "screen spec from Figma", "spec màn hình", "viết spec màn hình từ Figma", "画面仕様書", "Figmaから画面仕様書", "/atk:spec".

plugins/atk/skills/spec/SKILL.md

Read pinned source

Source commit 55481d2e4ae3cec8e2050c160303c751bbf20173

What was checked

Matches the observed repository HEAD
Yes
Scanner rules are current
No
Repository scan complete
No
Skill scan complete
No
Observed behavior
Not checked yet
Last checked
Nov 6, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings)
12
Repository last updated
Nov 9, 2026
License
MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files
Read excerpt

# Reference Specs (`atk:spec`)

Owns the document somebody opens to answer "what does this endpoint do today", or, in a project whose
profile says `Contract: first`, "what is this endpoint agreed to do". It carries no options, and in
the kit's own shape no history: it describes the system as it currently is or is agreed to be, which
is why a stale line in it is wrong rather than merely old, and why it is updated in place forever
instead of being superseded. `shared/spec-docs.md` holds what separates it from a design document, what changes under
`Contract: first`, and the obligation that keeps it true.

## Scope

Handles: writing and updating reference documents for API contracts, database schema, feature
behaviour, and screens, the last from a Figma design or the images exported from it; taking their shape from the documents a project already keeps; under `Contract: first`,
writing them from a design before the code exists and moving them onto the code as it lands; folding
Back to top