feature-spec SKILL.md skillA

feature-spec from hahaknight/claude-skills-pro is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add hahaknight/claude-skills-pro/feature-spec@git:20260911.d1f3748

Pins git:20260911.d1f3748 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
hahaknight/claude-skills-pro
Path
free-skills/feature-spec/SKILL.md
Versions recorded
4
Latest version
git:20260911.d1f3748, committed Sep 11, 2026
First version recorded
Aug 31, 2026
Size
3,070 bytes
Repository stars
6
License
MIT

MUST USE before implementing any non-trivial feature (new endpoint, new module, new user-facing behavior) or when the user describes a feature vaguely — 先出方案/需求不清/design first. Converts vague asks into a 1-page spec with scope, contracts, edge cases, and test scenarios — getting alignment BEFORE code is written. Part of claude-skills-pro - 8 more skills (security-audit, refactor-surgeon, perf-profiler, api-designer, db-migration-safe) + 11-chapter CN handbook, all free…

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

# Feature Spec — Design Before Code

Rework is the most expensive bug. This skill spends 5 minutes of spec to save hours of wrong implementation.

## Workflow

1. **Restate the ask in one sentence**: who does what, and what changes for them. If you can't, list your questions NOW and stop.
2. **Locate the boundaries** (read the actual code, don't assume):
   - What modules/files will this touch? Name them.
   - Existing patterns for the same kind of feature (find a sibling feature and mirror it — consistency beats creativity inside a codebase)
   - What must NOT change (invariants, public contracts, performance budgets)
3. **Write the one-page spec**:
   - **Goal & non-goals** (explicitly listing what we are NOT doing this round)
   - **Interface**: function signatures / API routes+payloads / DB schema deltas / CLI flags — the contract other code depends on
   - **Behavior table**: input → outcome, including at least 5 edge cases (empty, huge, malformed, unauthorized, concurrent)
   - **Error model**: what can fail and what the user/system sees for each
   - **Test scenarios**: 3–8, derived from the behavior table
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add hahaknight/claude-skills-pro/feature-spec@sha256:bb91e44616af4674

The line at the top of this page pins the label git:20260911.d1f3748, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_3jq66rrbpk73k7rn.svg)](https://markdownregistry.com/a/art_3jq66rrbpk73k7rn)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Aug 31, 2026 and Sep 11, 2026, about one every 3 days.

versioncommittedcommitsizeaudit
git:20260911.d1f3748 latest2026-09-11 d1f3748 3,070 BA view · diff
git:20260901.5a402f12026-09-01 5a402f1 3,337 BA view · diff
git:20260901.72e84bc2026-09-01 72e84bc 3,042 BA view · diff
git:20260831.684a6432026-08-31 684a643 2,805 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3070 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

GitHub

hahaknight/claude-skills-pro · 6 stars · license MIT · pushed 2026-09-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_3jq66rrbpk73k7rn
GET https://markdownregistry.com/api/v1/resolve?ref=hahaknight/claude-skills-pro/feature-spec
GET https://markdownregistry.com/api/v1/blob/bb91e44616af467457176d7d3260b07795f1dd3cc77c8eea8268acc7467b18e0

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 hahaknight/claude-skills-pro

ai-code-reviewer SKILL.md skill
hahaknight/claude-skills-pro · free-skills/ai-code-reviewer/SKILL.md · MUST USE when reviewing AI-generated code (Claude/ChatGPT/Copilot output), AI 写的代码/生成的代码能上线吗, or when a change was…
git:20260911.2fc2767 · audit A · 6 stars
bug-hunter SKILL.md skill
hahaknight/claude-skills-pro · free-skills/bug-hunter/SKILL.md · MUST USE when debugging, fixing a bug, 排查/调试/修 bug/为什么报错/不工作, or when tests fail unexpectedly. Systematic root-cause…
git:20260911.8715ef9 · audit A · 6 stars
changelog-release SKILL.md skill
hahaknight/claude-skills-pro · free-skills/changelog-release/SKILL.md · MUST USE when cutting a release, writing CHANGELOG entries / release notes / 发版/版本号, or deciding the next semver…
git:20260915.f7660cf · audit B · 6 stars
commit-craft SKILL.md skill
hahaknight/claude-skills-pro · free-skills/commit-craft/SKILL.md · MUST USE when writing git commit messages, 提交/commit/写提交信息, or when the user says commit this / 帮我提交. Groups changes…
git:20260911.47a49ea · audit A · 6 stars
geo-audit SKILL.md skill
hahaknight/claude-skills-pro · free-skills/geo-audit/SKILL.md · Five-dimension diagnostic for how AI search engines talk about a brand. Use when you have a question set plus raw AI…
git:20260915.f7660cf · audit A · 6 stars
pr-reviewer SKILL.md skill
hahaknight/claude-skills-pro · free-skills/pr-reviewer/SKILL.md · MUST USE when reviewing a pull request, reviewing changes, 审查代码/review/ 看看这个改动有没有问题, or before committing significant…
git:20260911.4cc920e · audit B · 6 stars
test-forge SKILL.md skill
hahaknight/claude-skills-pro · free-skills/test-forge/SKILL.md · MUST USE when writing tests, 补测试/write tests/单元测试/test coverage, or when asked to verify a module with tests. Produces…
git:20260911.282a72c · audit A · 6 stars

Every file in hahaknight/claude-skills-pro

Other files named feature-spec

feature-spec SKILL.md skill
davepoon/buildwithclaude · plugins/agent-triforce/skills/feature-spec/SKILL.md · Creates a complete product feature specification with acceptance criteria, scope, dependencies, and risks. Delegates to…
git:20260307.756e327 · audit A · 3,704 stars
feature-spec SKILL.md skill
qa-aman/claude-skills · skills/by-role/pm/feature-spec/SKILL.md · Write a concise feature spec for engineering handoff. Use when the user says "write a spec", "feature spec", "one-pager…
git:20260303.19bc151 · audit A · 24 stars
feature-spec SKILL.md skill
gonimar/claude-web-studio · skills/feature-spec/SKILL.md · Authors a feature specification (scenarios, rules, data, API operations, UI states, edge cases, security…
git:20260927.f32d805 · audit A · 5 stars

Browse by kind, by grade A, or by owner.