Agent skill
tech-spec-writer
Write implementation-ready software technical specifications for senior engineers.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/tech-spec-writer
SKILL.md
This skill follows engineering-doctrine and structured-workflow.
Interview (Required)
Before drafting the spec, interview the user to clarify requirements and intent:
- Ask focused questions about goals, scope, constraints, and success criteria.
- Confirm the intended users, workflows, and non-goals.
- Summarize the understanding and get explicit confirmation before writing the spec.
Output Requirements
- Markdown
- Explicit assumptions and open questions
- All requirements testable
- Tables preferred over prose
Required Sections (DO NOT OMIT)
- Title Page
- Purpose and Scope
- Background and Context
- Assumptions and Constraints
- Functional Requirements
- Non-Functional Requirements
- Architecture Overview
- Data Models
- APIs / Interfaces
- Error Handling
- Testing Strategy
- Open Questions
Specifications must be review-proof and suitable for long-term maintenance.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?