skill-builder

Creates new Skill units with consistent structure, templates, and quality validation.

Updated Jun 29, 2026
One-click install
npx skills add https://github.com/iJosueeh/amauta --skill skill-builder-ijosueeh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-builder
Source: https://github.com/iJosueeh/amauta/tree/main/.opencode/skills/skill-builder
Command: npx skills add https://github.com/iJosueeh/amauta --skill skill-builder-ijosueeh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Creating new Skills by hand leads to inconsistent structure, missing required sections, and unclear trigger descriptions that break dispatching. This Skill scaffolds new Skills following the framework's modular conventions so every Skill is structurally consistent and plug-and-play. ## Core Features & Use Cases - Template-Based Scaffolding: Copies the skill-template.md skeleton and fills required sections like Task, Dependency Check, First Principles, and Workflow. - Quality Rubric Scoring: Applies a 16-item, 32-point rubric with a ship threshold of 24 and critical-item-zero rules before shipping. - Eval Pack Generation: Initializes triggers.json and cases.json eval packs to verify trigger descriptions and output assertions. - Use Case: When an EVOLUTION.md proposal identifies a recurring need, use this Skill to generate a new compliant Skill directory with SKILL.md, references, and registration in the main control file. ## Quick Start Ask the assistant to create a new Skill named release-checker using the skill-builder workflow.

Frequently Asked Questions about skill-builder

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

FAQPage Schema
How do I create a new Skill with consistent structure?▼

Invoke the skill-builder workflow, which reads the skill-template.md skeleton, references 1-2 existing Skills matching your interaction mode, fills required sections, and registers the result in the main control file.

What sections are required in a SKILL.md file?▼

Required sections are Task, Dependency Check, First Principles, Not For, File Structure, Workflow, and Initialization. Recommended sections include Output Style, Dimension Checklist, Quality Rubric, Anti-Rationalization, and Gotchas.

How is Skill quality validated before shipping?▼

A 16-item, 32-point quality rubric scores dimensions like decidable triggers, workflow executability, and boundary clarity. The ship threshold is 24 points with no critical item scoring zero, computed via pnpm validate-skill.

When should I not use skill-builder?▼

Do not use it to modify existing Skills, which should be edited directly in their SKILL.md. It also does not handle evolving rules from feedback patterns or recording feedback, which belong to evolution-engine and feedback-writer.

What is a Skill eval pack and why is it needed?▼

An eval pack contains triggers.json with positive and near-miss trigger cases plus cases.json with output assertions. It verifies that the description triggers correctly and outputs do not regress, created via pnpm skill-eval init.