Create specification vs Update specification
Create specification is an open-source agent skill for developer tools. Update specification is an open-source agent skill for developer tools.
- Create specification is best for write a specification for a new internal api before implementation.
- Update specification is best for update a spec after a new feature requirement is added.
- What it is
- Create specification is an open-source agent skill for developer tools.Update specification is an open-source agent skill for developer tools.
- Best for
- Write a specification for a new internal API before implementationUpdate a spec after a new feature requirement is added
- Kind
- SkillSkill
- Pricing
- Open sourceOpen source
- Platforms
- Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, GooseClaude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- GitHub stars
- 41.3K41.3K
- Last commit
- Nov 2026Nov 2026
- License
- MITMIT
- Open source
- Good for
- Write a specification for a new internal API before implementation; Draft a requirements document for a data pipeline; Create an architecture spec for a microserviceUpdate a spec after a new feature requirement is added; Revise a specification to match recent changes in the codebase; Restructure an existing design document into an AI-readable spec
What Create specification does
Structured specification template
Provides a numbered Markdown template covering purpose, requirements, interfaces, acceptance criteria and validation.
Requirement identifiers
Uses prefixed IDs such as REQ, SEC, CON and GUD so each requirement and constraint can be referenced.
Acceptance criteria format
Encourages testable criteria written in Given-When-Then or shall-statement form.
Test strategy section
Includes a section for test levels, frameworks, test data handling and CI integration.
Dependency classification
Separates external systems, third-party services, infrastructure, data, platform and compliance dependencies.
Naming and front matter rules
Sets a filename convention under /spec/ and a YAML header with title, dates, owner and tags.
What Update specification does
Structured specification template
Provides a numbered template covering scope, requirements, interfaces, acceptance criteria and validation.
Labelled requirement identifiers
Asks for IDs such as REQ, SEC, CON and GUD so each rule can be referenced unambiguously.
Given-When-Then acceptance criteria
Guides writing testable acceptance criteria in a consistent behavioural format.
AI-ready writing rules
Requires explicit wording, defined acronyms and self-contained sections that suit machine parsing.
Dependency classification
Organises external systems, services, infrastructure, data and compliance dependencies into separate categories.
Test strategy outline
Lays out test levels, frameworks, data handling, CI integration and coverage expectations.
Create specification vs Update specification: questions
Is Create specification or Update specification cheaper?
Both are open source. Compare current plans on each official site.
What is the difference between Create specification and Update specification?
Create specification is an open-source agent skill for developer tools. Update specification is an open-source agent skill for developer tools.
