skill-designer

Scaffold agent skills with validated SKILL.md frontmatter and structured directories.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/dotBeeps/hoard --skill skill-designer-dotbeeps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-designer
Source: https://github.com/dotBeeps/hoard/tree/main/morsels/skills/skill-designer
Command: npx skills add https://github.com/dotBeeps/hoard --skill skill-designer-dotbeeps

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates inconsistent or poorly structured agent skills by providing clear rules, templates, and validation so new or existing SKILL.md files are discoverable, usable, and follow agentskills.io best practices.

Core Features & Use Cases

  • Frontmatter validation: Ensure name and description exist and follow naming rules for discoverability.
  • Scaffolding & templates: Provide archetype-specific templates (convention, tool, design) and directory scaffolds to jumpstart development.
  • Progressive disclosure guidance: Keep SKILL.md concise, move deep references to references/, and follow token/budget recommendations.
  • Quality checklist & review: Walk through naming, description quality, structure, content rationale, and release co-shipping rules.
  • Use Case: Create a new skill directory for a TypeScript conventions guide, validate its frontmatter, and split detailed examples into references/templates.md.

Quick Start

Scaffold a new skill named my-skill using the appropriate archetype template, include a matching frontmatter with name and description, add a references/templates.md file, and run the quality checklist.

Frequently Asked Questions about skill-designer

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

FAQPage Schema
How do I scaffold a new agent skill directory with valid SKILL.md frontmatter?

To scaffold an agent skill, use archetype-specific templates to generate a structured directory and validated SKILL.md frontmatter. This ensures the skill follows agentskills.io naming rules, required fields, and discoverability standards from the start.

What is progressive disclosure for agent skills and when should I use it?

Progressive disclosure keeps SKILL.md concise by moving deep references into a references/ directory. Use it to follow token budget recommendations, ensuring the main skill file remains focused while detailed examples and templates stay accessible.

How do I validate the frontmatter and description quality of an existing SKILL.md file?

Validate SKILL.md frontmatter by running a quality checklist that checks naming rules, required fields, and description trigger quality. This review process ensures the skill is discoverable and usable within Pi agent workflows.

What are the naming rules and required fields for production-ready agent skills?

Production-ready agent skills require valid name and description fields in the frontmatter. The skill name must follow specific naming rules for discoverability, and the description must have high trigger quality to activate correctly in Pi agent workflows.

Can I use skill templates for TypeScript conventions and split detailed examples into references?

Yes, you can use a convention archetype template to create a TypeScript guide skill, then split detailed examples into a references/templates.md file. This applies progressive disclosure to keep the main SKILL.md within token budgets.