skill-spec

Generate reproducible SPEC.md documents from interview data using a canonical template.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/iago-leal/skills --skill skill-spec-iago-leal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-spec
Source: https://github.com/iago-leal/skills/tree/main/skill-spec
Command: npx skills add https://github.com/iago-leal/skills --skill skill-spec-iago-leal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This set of tooling standardizes how skills are specified, enabling reproducible, audit-friendly skill definitions.

Core Features & Use Cases

  • Deterministic SPEC.md generation from interview data and reference templates.
  • Extraction, evaluation, and upgrade workflows for skill specifications.
  • Supports validation via a canonical scorer to ensure completeness and determinism.

Quick Start

Start by collecting interview data and run the skill-spec workflow to produce a deterministic SPEC.md.

Frequently Asked Questions about skill-spec

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

FAQPage Schema
How do I generate a reproducible SPEC.md document for skill definitions?

To generate a reproducible SPEC.md, collect interview data and run the skill-spec workflow to produce a deterministic document using a canonical template and scoring rubric. This ensures explicit frontmatter, section structure, and machine-checkable outputs.

What is deterministic skill specification and when do I need it?

Deterministic skill specification standardizes how skills are defined to ensure reproducible, audit-friendly outputs. You need it when creating, extracting, or upgrading skill specifications to guarantee completeness and consistency across the MDCU framework.

Can I use skill-spec to audit and upgrade existing skill specifications?

Yes, skill-spec supports extraction, evaluation, and upgrade workflows for skill specifications. It applies a canonical scorer to validate completeness, determinism, dependency pinning, and section structure for existing definitions.

Does skill-spec require specific dependencies to validate skill definitions?

No external dependencies are required. skill-spec relies on internal scripts and reference templates to apply its deterministic scoring rubric, checking frontmatter, script references, and machine-checkable outputs without external package prerequisites.

What's the best way to standardize skill documentation for machine-checkable reproducibility?

The best way to standardize skill documentation is applying a canonical SPEC.md template with a deterministic scoring rubric. This enforces explicit frontmatter, dependency pinning, and structured sections to ensure fully reproducible, machine-checkable skill definitions.

Why does my skill specification fail the deterministic scorer validation?

Skill specifications fail the deterministic scorer when they lack explicit frontmatter, proper section structure, script references, or dependency pinning. The scorer enforces canonical template compliance to ensure machine-checkable, reproducible outputs.