skill-scaffold

Scaffold SKILL.md files conforming to Skill Metadata Protocol v7.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/jacob-balslev/skill-graph --skill skill-scaffold-jacob-balslev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-scaffold
Source: https://github.com/jacob-balslev/skill-graph/tree/main/marketplace/skills/skill-scaffold
Command: npx skills add https://github.com/jacob-balslev/skill-graph --skill skill-scaffold-jacob-balslev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents new skills from shipping with cargo-culted template residue, inconsistent protocol frontmatter, or inflated/incorrect health claims by guiding authors to create a protocol-coherent SKILL.md specimen from scratch.

Core Features & Use Cases

  • Protocol-backed authoring flow: copy → adapt archetype → strip teaching notes → verify → commit.
  • Semantic-layer discipline: keeps description as a routing contract distinct from ## Coverage as a scope map.
  • Routing-eval honesty: defaults routing_eval: absent and only promotes to present after running the routing eval harness successfully.
  • Grounding and verification guidance: explains when and how to populate grounding truth sources and when to run lint/protocol consistency checks.

Quick Start

Use skill-scaffold to create a new SKILL.md from the canonical template, adapt the sections to the chosen archetype, remove all TEMPLATE NOTE teaching blocks, then run the skill lint and routing eval checks before committing.

Frequently Asked Questions about skill-scaffold

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

FAQPage Schema
How do I create a SKILL.md file that conforms to the Skill Metadata Protocol?

To create a SKILL.md file conforming to Skill Metadata Protocol v7, use skill-scaffold to generate the file from the canonical template, adapt archetype sections, and strip teaching-layer notes before committing.

What is the best way to remove template residue when authoring skill metadata?

Removing template residue when authoring skill metadata involves copying the canonical template, adapting it to your chosen archetype, and stripping all TEMPLATE NOTE teaching blocks to ensure a protocol-coherent SKILL.md specimen.

How does routing eval validation work for new skill files?

Routing eval validation defaults to absent during skill creation and only promotes to present after you successfully run the routing eval script, ensuring honest routing-eval claims in the SKILL.md metadata.

When do I need to run lint checks on a SKILL.md file?

You need to run lint checks on a SKILL.md file before committing to verify protocol consistency, validate semantic-layer discipline, and ensure grounding truth sources are correctly populated.

Can I use skill-scaffold to create workflow and router archetypes?

Yes, skill-scaffold supports creating brand-new capability, workflow, router, and overlay skills by adapting the canonical template sections to the chosen archetype while maintaining protocol frontmatter.

Why should the description field be kept separate from the coverage section in skill metadata?

The description field serves as a routing contract distinct from the Coverage section, which acts as a scope map; maintaining this semantic-layer discipline prevents inconsistent protocol frontmatter and inflated health claims.