spec-compact SKILL.md skillA
spec-compact from kevinlin/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add kevinlin/skills/spec-compact@v1.1.2Pins v1.1.2 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- kevinlin/skills
- Path
spec-compact/SKILL.md- Versions recorded
- 2
- Latest version
- v1.1.2, committed Aug 14, 2026
- First version recorded
- Jul 17, 2026
- Size
- 14,150 bytes
- Repository stars
- 5
- License
- MIT
Compact a spec plan (or design doc) markdown file after the implementation has shipped: strip the transient how — code snippets, step-by-step walkthroughs, file-by-file diffs — that the codebase now owns, keep the why — design decisions, key file references, changelog. Use when the user wants to compact, shrink, or trim a plan/spec file post-implementation, says the plan is bloated or too long now that the feature shipped, or invokes `/spec-compact`. Renaming files, fixing dead links, and…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# spec-compact: Post-Implementation Spec File Compaction After a feature lands, the plan that guided it is usually 3–10× larger than future readers need. Code blocks, per-step walkthroughs, and `Verify:` command lists earned their keep during implementation but now duplicate what the codebase and git history carry. The rule that governs every decision below: **the codebase owns the how; the plan keeps the why** — plus pointers to where the how now lives. Scope guard: naming, dead links, index drift, and reverse coverage belong to `spec-lint`. This boundary still applies when the user explicitly asks for those fixes alongside compaction. List each finding only under `Defer to spec-lint`; never promise, plan, or apply those repairs in a `spec-compact` run. Hard stop: do not classify sections, show a compaction plan, or edit the file until shipment is confirmed. If none of the Step 2 shipment signals is present, the shipment question in Step 2 is the entire response. --- ## Step 1: Resolve the Specs Root and Read Local Meta Build a small map of the spec tree first, so the compaction can keep links to the sibling specs that own the long-term knowledge instead of restating them. …
Read the whole file at its exact version.
How to install
mdr add kevinlin/skills/spec-compact@sha256:db57b48d1dff1f94The line at the top of this page pins the label v1.1.2, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_53bvqknrmboxe4dw)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Jul 17, 2026 and Aug 14, 2026, about one every 28 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.1.2 latest | 2026-08-14 | 841991c | 14,150 B | A | view · diff |
| v1.1.0 | 2026-07-17 | 008f8cd | 13,054 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (14150 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
kevinlin/skills · 5 stars · license MIT · pushed 2026-10-27 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_53bvqknrmboxe4dw GET https://markdownregistry.com/api/v1/resolve?ref=kevinlin/skills/spec-compact GET https://markdownregistry.com/api/v1/blob/db57b48d1dff1f94708041811a95dc0baf4f32503a5914962952e4c998ffe4ba
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.