advanced-skill-builder

Design and audit SKILL.md based agent skills with canonical structure and guardrails.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/MADTeacher/skills --skill advanced-skill-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: advanced-skill-builder
Source: https://github.com/MADTeacher/skills/tree/main/advanced-skill-builder
Command: npx skills add https://github.com/MADTeacher/skills --skill advanced-skill-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Design and audit advanced agent skills to create maintainable, reusable SKILL.md based projects.

Core Features & Use Cases

  • Establish operational contracts and governing principles to ensure skills are actionable by agents.
  • Enforce canonical project structure with a clear boundary between description, SKILL.md, references, scripts, and assets.
  • Provide progressive disclosure patterns, validation, and guardrails to prevent bypass and enable forward-testing.

Quick Start

Create or update your local skill at .agents/skills/<skill-name>/SKILL.md following the Minimal SKILL.md template.

Frequently Asked Questions about advanced-skill-builder

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

FAQPage Schema
How do I design agent skills with proper routing and validation guardrails?

To design agent skills with routing and validation, you establish operational contracts and canonical project structures. This enforces frontmatter discipline and guardrails, ensuring testable, forward-tested outcomes for maintainable projects.

What is a canonical SKILL.md structure for maintainable agent workflows?

A canonical SKILL.md structure separates description, routing logic, references, scripts, and assets into clear boundaries. This progressive disclosure pattern prevents bypass and ensures agent skills remain reusable and testable.

How do I audit existing agent skills for risk-management and frontmatter discipline?

Auditing agent skills for risk-management involves checking frontmatter discipline and routing guardrails against a canonical template. You verify operational contracts and layered resources to ensure forward-tested, actionable outcomes.

Does progressive disclosure work for preventing bypass in agent skill routing?

Progressive disclosure works for preventing bypass by structuring layered resources and validation guardrails within the skill design. This enforces canonical boundaries and frontmatter discipline to achieve testable, forward-tested outcomes.

What's the best way to establish operational contracts for agent skills?

The best way to establish operational contracts for agent skills is applying a canonical SKILL.md template with clear boundaries. This enforces governing principles, routing validation, and guardrails to ensure agents execute tasks actionably.

When should I not use a layered resource structure for agent skill design?

You should not use a layered resource structure for agent skill design when a project lacks routing complexity or requires no frontmatter discipline. Simple workflows without risk-management needs do not warrant canonical boundaries or progressive disclosure.