skill-spec

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

Updated Aug 27, 2026

Search Tags:#templates #documentation #skills #spec #deterministic #scorer

Ready to run

npx skills add https://github.com/iago-leal/skills --skill skill-spec-iago-leal

💬 Prompt for ChatGPT / Claude Chat▼

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.