spec

Execute specification files for migrations, builds, tests, and deployments.

2|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/VitorMRodovalho/ai-pm-research-hub --skill spec-vitormrodovalho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/VitorMRodovalho/ai-pm-research-hub/tree/main/.claude/skills/spec
Command: npx skills add https://github.com/VitorMRodovalho/ai-pm-research-hub --skill spec-vitormrodovalho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates executing repository specification files that describe deliverables, turning manual spec interpretation into a deterministic, auditable execution flow that runs migrations, code updates, builds, tests, and deployments while enforcing stop-on-failure behavior.

Core Features & Use Cases

  • Spec-driven Execution: Reads a spec file, enumerates deliverables, and executes them in the defined order.
  • Preflight Validation: Checks prerequisites such as RPC endpoints, database tables, and schema columns before making changes.
  • Verification & Deployment: Runs build and test commands, produces a verification table matching the spec checklist, and commits with a descriptive message referencing the GC number.
  • Use Case: A product leader provides a change spec that includes a migration, an edge-function update, and a verification checklist; the Skill executes the steps, halts on any failure, and reports results.

Quick Start

Execute the spec file at the repository path and run its deliverables including prerequisite checks, migrations, builds, tests, and deploy if all verifications pass.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I automate spec-driven deployments and database migrations?

Spec-driven deployments are automated by executing specification files that sequentially run database migrations, code updates, builds, and tests while enforcing stop-on-failure behavior for auditable results.

What is spec-driven execution for product-led engineering workflows?

Spec-driven execution is the process of reading a repository change specification, enumerating deliverables, and systematically applying code edits and migrations to produce deterministic deployment results.

Does spec execution validate database schema and RPC endpoints before running migrations?

Spec execution validates prerequisites including RPC endpoints, database tables, and schema columns before applying migrations or code updates to ensure deployment checks pass without runtime errors.

How do I verify deployment checklists and build tests in a CI pipeline?

Verify deployment checklists by running build and test commands during spec execution, which produces a verification table matching the spec checklist and stops on any test failure.

What happens when build or test commands fail during a spec-driven deployment?

When build or test commands fail during spec-driven deployment, the execution halts immediately to prevent invalid states, ensuring only fully verified changes are committed with the GC number reference.

Can I use spec files to deploy edge function updates and commit changes automatically?

You can use spec files to deploy edge function updates by executing the specification, which applies changes, runs verifications, and commits with a descriptive message referencing the GC number.