skills.rest
dominikpalatynski
dominikpalatynskiCOMMUNITY
Explore all skills by this author →
GitHub

spec-writing

Guide teams to craft, review, and finalize SPECs aligned with architecture and quality rules.

Updated Apr 1, 2026
Search Tags:#architecture#documentation#checklist#specification#review#spec-writing
One-click install
npx skills add https://github.com/dominikpalatynski/test-ready-app --skill spec-writing-dominikpalatynski
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-writing
Source: https://github.com/dominikpalatynski/test-ready-app/tree/main/.ai/skills/spec-writing
Command: npx skills add https://github.com/dominikpalatynski/test-ready-app --skill spec-writing-dominikpalatynski

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

spec-writing helps teams craft, review, and finalize SPECs that align with architectural standards and quality rules, reducing gaps and miscommunication.

Core Features & Use Cases

  • Skeleton-first SPEC creation to surface critical unknowns early.
  • Open Questions tracking and iterative refinement until a stable spec emerges.
  • Alignment with reference materials and architecture through structured templates and checklists.

Quick Start

Load AGENTS.md and existing specs, then initialize SPEC-{number}-{date}-{title}.md in .ai/specs/ and begin with a TLDR skeleton.

Frequently Asked Questions about spec-writing

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

FAQPage Schema
How do I write a technical specification that aligns with architecture standards?▼

A specification skeleton is a high-level structural outline that captures critical unknowns early. It enforces tracking open questions and iterative refinement before finalizing detailed architectural requirements.

How do I audit an existing spec for gaps and missing requirements?▼

Audit existing specifications by checking them against structured checklists, architecture standards, and reference materials to identify gaps, track open questions, and enforce iterative refinement until requirements are stable.

What is the best way to track open questions during specification writing?▼

Track open questions by maintaining them within a skeleton-first specification template, enforcing iterative refinement cycles until all unknowns are resolved and a stable spec emerges for final review.

How do I create a phased implementation plan from a finalized spec?▼

Generate a phased implementation plan by finalizing the specification through iterative refinement, then using the structured template and checklist outputs to define sequential execution phases for implementation.

When should I use a checklist for specification review?▼

Use a specification review checklist when auditing existing specs against quality rules and architecture standards, ensuring all workflows, references, and open questions are fully resolved before final approval.

Does skeleton-first specification writing work for complex architecture documentation?▼

Skeleton-first specification writing works for complex architecture documentation by using structured templates to surface critical unknowns early, enabling iterative refinement and alignment with references before finalizing.

Related Skills

Explore More Content & Communication Skills→
pradeepmoulipradeepmouli
2

speckit-baseline

Generate baseline-spec.md and current-state.md from repository analysis.

Community
Advanced
racciolyraccioly

speckit-plan

Generate end-to-end technical implementation plans from feature specifications.

Community
Advanced
abranjithabranjith

review-code

Review code changes against plan and feature specifications.

Community
Advanced
cafe3310cafe3310
248

doc-template-provider

Generate standardized project and product documentation from reusable markdown templates.

Community
Basic