new-spec SKILL.md skillA
new-spec from eugenelim/agent-ready-repo is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add eugenelim/agent-ready-repo/new-spec@git:20261031.f9bbf6ePins git:20261031.f9bbf6e in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- eugenelim/agent-ready-repo
- Path
packs/core/.apm/skills/new-spec/SKILL.md- Versions recorded
- 20
- Latest version
- git:20261031.f9bbf6e, committed Oct 31, 2026
- First version recorded
- Sep 10, 2026
- Size
- 51,566 bytes
- Repository stars
- 28
- License
- Apache-2.0
Use this skill when the user wants to start a new feature with a spec, or wants to write a spec for something they're about to build. Triggers on "new spec", "write a spec for X", "let's spec this out", "start a feature for...". Spec-driven development; the spec drives implementation. Do NOT use for cross-cutting proposals (use `new-rfc`) or recording decisions (use `new-adr`).
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
# Skill: new-spec Create a new feature spec under `docs/specs/<feature>/` with both `spec.md` and `plan.md`. ## Output rendering <!-- agentbundle:output-rendering:start --> Lead with the useful outcome or next action. Use warm, non-blaming language and everyday words. Define an unfamiliar term in a few plain words before naming it; keep proper names and exact technical terms intact. During tool work, do not narrate routine calls. Send an update only for safety, a blocker, a needed decision, a material scope change, a long wait, or an active host requirement. When requesting input, ask only for what is needed now. Ask dependent questions one at a time; otherwise group related questions. Offer no more than three clear choices when choices help. Shape the answer to the facts: one fact needs one sentence; related facts use prose; separate items use bullets; real sequences use numbered steps. For prose artifacts, use descriptive headings, short resumable sections, one fact per sentence, and no repeated summary. Emphasize at most one load-bearing point per section. Group long inventories instead of truncating them. …
Read the whole file at its exact version.
How to install
mdr add eugenelim/agent-ready-repo/new-spec@sha256:e6a96178bced2c1dThe line at the top of this page pins the label git:20261031.f9bbf6e, 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_gp5cm6l5xrrbwpxf)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 20 versions of this file, between Sep 10, 2026 and Oct 31, 2026, about one every 3 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261031.f9bbf6e latest | 2026-10-31 | f9bbf6e | 51,566 B | A | view · diff |
| git:20261030.a8e59fb | 2026-10-30 | a8e59fb | 51,290 B | A | view · diff |
| git:20261029.0f9e42c | 2026-10-29 | 0f9e42c | 51,237 B | A | view · diff |
| git:20261028.8b7d655 | 2026-10-28 | 8b7d655 | 50,869 B | A | view · diff |
| git:20261028.42d02f3 | 2026-10-28 | 42d02f3 | 50,356 B | A | view · diff |
| git:20261021.3cc898b | 2026-10-21 | 3cc898b | 50,364 B | A | view · diff |
| git:20261021.793cd96 | 2026-10-21 | 793cd96 | 49,708 B | A | view · diff |
| git:20261005.ff170f0 | 2026-10-05 | ff170f0 | 49,732 B | A | view · diff |
| git:20261001.1e12326 | 2026-10-01 | 1e12326 | 49,796 B | A | view · diff |
| git:20260923.5a06c2b | 2026-09-23 | 5a06c2b | 49,552 B | A | view · diff |
| git:20260918.e386f98 | 2026-09-18 | e386f98 | 49,493 B | A | view · diff |
| git:20260918.1ee13a9 | 2026-09-18 | 1ee13a9 | 49,306 B | A | view · diff |
| git:20260918.e43cc76 | 2026-09-18 | e43cc76 | 49,345 B | A | view · diff |
| git:20260918.f929b39 | 2026-09-18 | f929b39 | 48,177 B | A | view · diff |
| git:20260917.813f533 | 2026-09-17 | 813f533 | 46,264 B | A | view · diff |
| git:20260913.a9f9994 | 2026-09-13 | a9f9994 | 46,218 B | A | view · diff |
| git:20260913.fd6d168 | 2026-09-13 | fd6d168 | 46,127 B | A | view · diff |
| git:20260913.6354fda | 2026-09-13 | 6354fda | 45,475 B | A | view · diff |
| git:20260912.95754ea | 2026-09-12 | 95754ea | 45,622 B | A | view · diff |
| git:20260910.e2dc29c | 2026-09-10 | e2dc29c | 40,177 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 (51566 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
eugenelim/agent-ready-repo · 28 stars · license Apache-2.0 · pushed 2026-11-02 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_gp5cm6l5xrrbwpxf GET https://markdownregistry.com/api/v1/resolve?ref=eugenelim/agent-ready-repo/new-spec GET https://markdownregistry.com/api/v1/blob/e6a96178bced2c1d24e4d9f5c113accf57cca0bb0a8acc9b2c43f49559ea6fcf
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.
More from eugenelim/agent-ready-repo
Every file in eugenelim/agent-ready-repo