skills.rest
ydnikolaev
ydnikolaevCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

tech-spec-writer

Convert architecture context maps, API contracts, and user stories into draft technical specifications with test skeletons.

8|3|Updated Jan 21, 2026
Search Tags:#architecture#documentation#TDD#specification#technical-writing#api-contracts#context-map
One-click install
npx skills add https://github.com/ydnikolaev/antigravity-factory --skill tech-spec-writer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tech-spec-writer
Source: https://github.com/ydnikolaev/antigravity-factory/tree/main/src/skills/tech-spec-writer
Command: npx skills add https://github.com/ydnikolaev/antigravity-factory --skill tech-spec-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill translates high-level architecture into detailed, human-readable Technical Specifications, bridging the gap between Architects and Developers to accelerate delivery.

Core Features & Use Cases

  • Architect-to-Developer Translation: Converts context maps, API contracts, and user stories into precise, testable specs.
  • Live Draft & TDD Support: Produces a test skeleton and guides iterative refinement to align with product goals.
  • Collaborative Handoff: Ensures traceability to artifacts and lifecycle state for smooth handoffs and reviews.

Quick Start

Provide the architecture context, API contracts, and user stories, then request a draft tech-spec for a feature and iterate until approved.

Frequently Asked Questions about tech-spec-writer

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

FAQPage Schema
How do I translate high-level architecture into a detailed technical specification?▼

To translate architecture into a technical specification, provide context maps, API contracts, and user stories to generate a human-readable draft spec with a test skeleton for developer handoffs.

What is the best way to generate a test skeleton from API contracts and user stories?▼

Generating a test skeleton from API contracts involves mapping specifications to product goals, producing a draft technical specification that includes a test skeleton for iterative refinement.

Can I use context maps to create testable technical specifications for developer handoffs?▼

Yes, you can use context maps to create testable technical specifications by converting architectural artifacts and user stories into precise, traceable documents that facilitate collaborative handoffs.

How do I bridge the communication gap between architects and developers during project delivery?▼

Bridging the gap between architects and developers requires translating architecture into detailed technical specifications, ensuring traceability to lifecycle states and artifacts for smooth reviews.

When do I need a technical specification for architecture-driven projects?▼

You need a technical specification for architecture-driven projects when clear handoffs between architects and developers are required, leveraging API contracts and context maps to accelerate delivery.

Does test-driven development work with iterative technical specification drafts?▼

Test-driven development works with iterative specification drafts by aligning the produced test skeleton with product goals through continuous refinement until the technical specification is approved.

Related Skills

Explore More Software Engineering Skills→
ydnikolaevydnikolaev
8

product-analyst

Translate product vision into user stories, requirements, and roadmaps.

Community
Advanced
whichguywhichguy

review-coverage

Enforce structured post-implementation verification through iterative review-converge cycles.

Community
Advanced
liminal-ailiminal-ai

lss-tech

Embed architectural decisions and test mappings into functional story text.

Official
Advanced
AsiaOstrichAsiaOstrich
70

forward-derivation

Generate BDD scenarios, TDD skeletons, and ATDD tables from SDD specifications.

Community
Intermediate