skills.rest
vankichi
vankichiCOMMUNITY
Explore all skills by this author →
GitHub

write-spec

Convert design drafts into spec contracts validated against spec-contract.md.

Updated May 2, 2020
Search Tags:#specification#iterative development#design validation#contract verification#question and answer
One-click install
npx skills add https://github.com/vankichi/dotfiles --skill write-spec-vankichi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-spec
Source: https://github.com/vankichi/dotfiles/tree/main/claude/ja/skills/write-spec
Command: npx skills add https://github.com/vankichi/dotfiles --skill write-spec-vankichi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill assists in transforming human-generated design drafts into complete spec contracts that adhere to the rules specified in the 'spec-contract.md' file.

Core Features & Use Cases

  • Spec Completion: Automatically fill in missing sections and clarify ambiguous areas in design drafts.
  • Question & Answer: Engage in iterative questioning to ensure all requirements are met.
  • Contract Verification: Validate the spec against the 'spec-contract.md' file to ensure compliance.
  • Output: Provide a finished spec document that is ready for review and implementation.

Quick Start

Use the write-spec skill to transform your design draft into a spec contract by providing the draft as input.

Frequently Asked Questions about write-spec

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

FAQPage Schema
How do I convert a human design draft into a complete spec contract?▼

To convert a human design draft into a complete spec contract, provide the draft as input to automatically fill missing sections and clarify ambiguous areas through iterative questioning.

How does iterative questioning validate spec contract requirements?▼

Iterative questioning validates spec contract requirements by engaging the user in targeted Q&A to resolve ambiguities and ensure the final design draft meets all predefined compliance rules.

What is the best way to validate a specification against a contract file?▼

The best way to validate a specification against a contract file is to validate the finalized spec document directly against the 'spec-contract.md' file to ensure strict compliance.

Can I use this to fill in missing sections for software design validation?▼

Yes, you can use this for software design validation to automatically complete missing sections in design drafts and output a finished spec document ready for implementation.

Do I need a 'spec-contract.md' file to verify design drafts?▼

Yes, you need a 'spec-contract.md' file because contract verification checks the finalized design draft against the specific rules defined within that file to ensure compliance.

Why does my design draft need iterative question and answer sessions?▼

Your design draft needs iterative question and answer sessions to clarify ambiguous areas, guarantee all requirements are met, and output a fully validated spec contract.

Related Skills

Explore More Software Engineering Skills→
WASIDJWASIDJ

trellis-update-spec

Document executable contracts and coding conventions into .trellis/spec/ documents.

Community
Advanced
rhussrhuss
107

implement

Generate implementation plans and TDD cycles from validated specifications.

Community
Basic
chohra-medchohra-med
28

spec-harness-plan

Convert finalized product specifications into structured design.md documents aligned with project standards.

Community
Advanced
paxlabs-incpaxlabs-inc
7

technical-architecture-proposal

Generate technical architecture proposals from codebase analysis and seam-finding.

Community
Advanced