ateam-spec

Generates a dev-facing spec.md mapping design screens to component library names and tokens.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/subvisual/the-a-team --skill ateam-spec-subvisual
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ateam-spec
Source: https://github.com/subvisual/the-a-team/tree/main/.claude/skills/ateam-spec
Command: npx skills add https://github.com/subvisual/the-a-team --skill ateam-spec-subvisual

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It converts an approved design.md into a precise, developer-facing specification so engineers build from real component-library names and design tokens instead of bespoke, ad-hoc UI decisions. ## Core Features & Use Cases - Component resolution: Maps every screen element to the target project's own component library, or to shadcn/ui registry names under the declared default, with binding > default > TBD precedence. - Complete state coverage: Specifies empty, loading, error, and populated states per component, plus responsive behavior, interactions, and edge cases, with zero raw px/hex values. - Acceptance obligation preservation: Carries canonical acceptance obligations, component-states JSON declarations, and rendered-review plans into the spec for downstream verification. - Use Case: After the design phase approves design.md for a feature, run this skill to produce spec.md with a deduplicated components-to-install list and a design-system gaps report that the issues phase turns into setup work. ## Quick Start Run the spec phase over the approved design.md in the current feature directory to generate spec.md with component mappings, states, and install lists.

Frequently Asked Questions about ateam-spec

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

FAQPage Schema
How do I turn a design document into a developer specification?▼

Run this skill over an approved design.md containing a parseable Screens & flows section. It produces spec.md with a component breakdown per screen, all four states per component, responsive behavior, and a components-to-install list resolved against your design system.

How does the skill choose between shadcn/ui and an existing component library?▼

Resolution follows binding > default > TBD precedence. An existing target-project component library always wins; otherwise the declared shadcn/ui default applies and is recorded as a confidence-stamped assumption. Contradictory evidence produces a flagged TBD resolution.

Can the spec contain raw pixel or hex color values?▼

No. All colors must be token role variables like --primary or scale steps like brand-600, and spacing and type must use scale.ts names. A value with no token is flagged as a design-system gap rather than inlined.

What happens when the spec phase cannot resolve a component?▼

Unresolvable pieces are first specced as composites of primitives; only truly bespoke components get a custom: marker, which becomes a loud flag in the phase report. Gaps become visible TBDs, never invented answers or stalls.

When does the spec phase stop instead of completing autonomously?▼

It hard-stops when design.md is missing or lacks a parseable Screens & flows section, or when no design-system token vocabulary exists in either docs/product/design-system/ or the target repo. It leaves status in_progress and reports the reason.