spec

Create structured specifications from feature goals before implementation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns a vague feature goal into a complete, implementation-ready specification before any code is written, reducing ambiguity and rework.

Core Features & Use Cases

  • Progressive Specification Writing: Expands a short goal into a structured design document with problem statement, constraints, approach, contracts, rollout, and acceptance criteria.
  • Codebase-Grounded Analysis: Grounds the spec in the actual repository so the design reflects existing patterns, boundaries, and reusable components.
  • Validation and Review: Checks the draft for factual issues, pattern conflicts, and architectural risks before marking it ready for implementation.
  • Use Case: Use this Skill when you need to align on a new feature, evaluate multiple implementation options, or document a cross-cutting change before development starts.

Quick Start

Ask the spec skill to create a structured specification for your feature goal and include any known constraints or design preferences.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I create a structured specification from a feature goal before coding?

To create a structured specification from a feature goal, expand your short objective into a design document covering the problem statement, constraints, approach, contracts, rollout, and acceptance criteria using progressive elaboration before implementation begins.

What is codebase-grounded analysis in software specification writing?

Codebase-grounded analysis in software specification writing grounds your design document in the actual repository, ensuring the proposed architecture reflects existing patterns, boundaries, and reusable components rather than designing in isolation.

When do I need to write a technical specification for architectural changes?

You need to write a technical specification for architectural changes when a cross-cutting decision requires alignment, validation, documented acceptance criteria, and review of existing patterns and public interfaces before development starts.

How do I validate a software design document for architectural risks?

To validate a software design document for architectural risks, check the draft specification for factual issues, pattern conflicts, and architectural risks against the actual codebase before marking it ready for implementation.

Can I use specification writing for evaluating multiple implementation options?

Yes, you can use specification writing for evaluating multiple implementation options by applying progressive elaboration to document each approach, compare constraints, and establish validated acceptance criteria before committing to code.

Does specification writing work without an existing codebase to analyze?

Specification writing without an existing codebase skips the codebase-grounded analysis phase, meaning the design document will lack validation against existing patterns, boundaries, and reusable components, increasing the risk of integration conflicts.