skill-builder

Create, audit, and refactor SKILL.md files against Agent Skills quality standards.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/r-senchuk/agentskills --skill skill-builder-r-senchuk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-builder
Source: https://github.com/r-senchuk/agentskills/tree/main/.agents/skills/skill-builder
Command: npx skills add https://github.com/r-senchuk/agentskills --skill skill-builder-r-senchuk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing a high-quality SKILL.md requires knowing the Agent Skills specification, avoiding duplication with existing skills, and passing structural validation — this Skill codifies that entire workflow into a repeatable procedure. ## Core Features & Use Cases - Create new skills: Researches the domain via web and GitHub search, designs the required section structure, and writes a validated SKILL.md with correct frontmatter. - Audit existing skills: Checks a skill against a quality checklist covering frontmatter, trigger phrases, section order, reference integrity, and line limits, then produces a gap report and applies fixes. - Refactor and validate: Restructures non-compliant skills, runs a bash validation script for name/folder match and required sections, and optionally creates a Claude Code companion file. - Use Case: You want to add a new skill for Terraform workflows to your Copilot skills collection — this Skill inventories existing skills, researches comparable SKILL.md files on GitHub, writes the new skill, and validates it end to end. ## Quick Start Ask the agent to create a new skill for your chosen domain using the skill-builder workflow and validate it against the quality checklist.

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.md for GitHub Copilot?▼

Define a kebab-case name matching its folder, write YAML frontmatter with name and description fields, then add the five required sections: When To Use, Inputs To Collect First, Procedure, Completion Checks, and References. Validate with the provided bash script.

How to audit an existing agent skill for quality issues?▼

Read the SKILL.md fully, check it against the quality checklist covering frontmatter, trigger phrases, section order, and reference integrity, then write a gap report table and apply all fixes directly to the file.

What frontmatter fields are required in a SKILL.md file?▼

Only name and description are required. The name must be 1-64 lowercase kebab-case characters matching the folder exactly, and the description must state what the skill does and when to use it, within 1024 characters.

Why does my skill fail to load with a YAML frontmatter error?▼

Check that the --- delimiters appear on the first lines with no leading spaces or BOM characters, and that no non-standard sections appear before When To Use. Parse the frontmatter with a YAML validator to surface syntax errors.

Why does my skill never auto-trigger or trigger on unrelated queries?▼

A generic description causes missed triggers, so add domain-specific nouns and exact user phrase patterns. Overtriggering is fixed by adding an explicit Do NOT use for clause in both the description and When To Use section.

When should content be moved from SKILL.md to reference files?▼

Extract any section that would push the body beyond 500 lines into ./references/ files, which load only when invoked. Keep the core procedure in the body and put lookup tables, templates, and advanced detail in references.