specify

Transforms a product requirements document into testable acceptance criteria filed in the project's requirements store.

Updated Feb 12, 2026
One-click install
npx skills add https://github.com/kieranpotts/skills --skill specify-kieranpotts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: specify
Source: https://github.com/kieranpotts/skills/tree/main/skills/specify
Command: npx skills add https://github.com/kieranpotts/skills --skill specify-kieranpotts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning informal, business-language product requirements documents into formal, testable software requirements is slow and error-prone, and agents often invent missing details. This Skill converts a PRD into acceptance criteria while rejecting incomplete inputs instead of guessing. ## Core Features & Use Cases - PRD validation: Checks the PRD for user, goal, value, rules, examples, scope, and non-functional requirements, and rejects it with an itemized gap list when it falls short. - Store-aware filing: Discovers where the project keeps requirements, learns that store's template, lifecycle, and filing mechanics, and files the specification at its "awaiting review" state. - Behavior-only specifications: Maps PRD rules and examples to functional acceptance criteria and NFRs to measurable quality requirements, with no implementation detail leaking in. - Use Case: After a discovery session produces a PRD for a new feature, run this Skill to turn it into acceptance criteria that downstream design and test steps can use as a deterministic fitness function. ## Quick Start Turn this PRD into acceptance criteria and file the specification in our requirements store for review.

Frequently Asked Questions about specify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a PRD into acceptance criteria?▼

Supply the PRD as a file path, pasted text, or earlier session output and invoke the specify skill. It validates the PRD, maps its rules and examples to functional acceptance criteria, and files the result in your project's requirements store awaiting review.

What happens if my PRD is incomplete or vague?▼

The skill rejects the PRD with an itemized list of missing elements, such as rules, examples, scope boundaries, or measurable NFR targets. It never invents missing requirements; only purely mechanical gaps like titles or phrasing may be normalized.

Does the specify skill work with external requirements trackers or wikis?▼

Yes. The specification store can be a repository directory, a separate repository, or an external service like a tracker or wiki. The skill discovers the store from session context or environment, learns its conventions, and files accordingly.

Can the specify skill gather missing requirements from the user?▼

No. It runs non-interactively and never elicits requirements. Its only permitted question is where the project's requirements live, and only when context and environment do not settle that.

When should I not use the specify skill?▼

Do not use it for pure refactors or internal-quality changes, which produce no new acceptance criteria. It also does not approve specifications or begin design work; approval remains the user's decision.