show-spec-working

Demonstrates OpenSpec changes, endpoints, and frontend flows using runnable verification steps.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/Marcel-Carrillo/ProyectosIA --skill show-spec-working-marcel-carrillo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: show-spec-working
Source: https://github.com/Marcel-Carrillo/ProyectosIA/tree/main/ai-specs/skills/show-spec-working
Command: npx skills add https://github.com/Marcel-Carrillo/ProyectosIA --skill show-spec-working-marcel-carrillo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working with spec-driven development, it is hard to prove that a feature, endpoint, or OpenSpec change actually works as specified. This Skill turns vague "show me it works" requests into structured, evidence-based demonstrations using the safest available method. ## Core Features & Use Cases - Four Demonstration Modes: Runnable frontend walkthroughs, backend API demos with explicit curl commands, spec-based walkthroughs when no implementation exists, and evidence-based code walkthroughs when code cannot be run safely. - Selective Context Loading: Reads only the minimal OpenSpec artifacts, API specs, and standards docs needed for the requested target instead of scanning the whole repository. - Data Safety Guardrails: Masks sensitive values, asks approval before state-changing requests, restores demo data, and never exposes supplier costs or internal fulfillment data in customer-facing demos. - Use Case: A developer finishes the product-catalog-management OpenSpec change and asks "show the product catalog working" — the Skill resolves the target, verifies the API with curl commands, and reports a structured completion summary with pass/fail per scenario. ## Quick Start Ask the assistant to show the product catalog feature working using the show-spec-working skill and provide the OpenSpec change name or endpoint you want verified.

Frequently Asked Questions about show-spec-working

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

FAQPage Schema
How do I demonstrate an OpenSpec change is working?▼

Provide the change name, such as product-catalog-management, and the Skill loads its proposal, tasks, and spec files, then picks a demo mode. If implementation exists it runs frontend or API verification; otherwise it walks through the spec's WHEN/THEN scenarios.

How to verify a backend API endpoint with curl?▼

The Skill identifies the endpoint from docs/api-spec.yml, builds explicit curl commands with sample payloads, and executes read-only requests directly. State-changing requests require your approval first, and demo data is restored afterward.

Can it demo a feature that has no implementation yet?▼

Yes, it uses spec-based demonstration mode. It walks through each requirement's WHEN/THEN behavior from the OpenSpec artifacts and clearly labels the result as a spec demo, not a live runtime demo.

Does it support browser automation for frontend demos?▼

Browser automation is used only when available in the current agent environment, such as a browser or Playwright MCP. If unavailable, the Skill provides manual demo steps with expected results for each scenario instead.

What safety limits apply during demonstrations?▼

The Skill never implements code, edits files, installs dependencies, runs migrations, or starts services without approval. It also never exposes supplier costs, credentials, or internal fulfillment notes in customer-facing demos.