Skill Builder

Guide creation of reusable AI skills with SKILL.md structure and YAML frontmatter.

Updated Nov 15, 2025

Search Tags:#workflow #template #documentation #metadata #skill #create

Ready to run

npx skills add https://github.com/brendanbecker/SREcodex --skill skill-builder-brendanbecker

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Skill Builder
Source: https://github.com/brendanbecker/SREcodex/tree/main/skills/skill-builder
Command: npx skills add https://github.com/brendanbecker/SREcodex --skill skill-builder-brendanbecker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide and template for creating new, reusable skills, ensuring they are discoverable, actionable, and follow best practices for AI-driven workflows.

Core Features & Use Cases

Skill Structure Guidance: Detailed breakdown of the SKILL.md format, including YAML frontmatter and Markdown body.
Discovery Metadata Best Practices: Emphasis on name, description, tags, and intent for effective AI discovery.
Step-by-Step Creation Process: From identifying patterns to testing and integration.
Use Case: When you identify a recurring task or a valuable technique that could benefit future AI sessions, use this skill to standardize its creation and ensure it's easily discoverable and usable.

Quick Start

Use the skill builder to create a new skill for managing environment variables.

Frequently Asked Questions about Skill Builder

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

FAQPage Schema

How do I create reusable AI skills with proper metadata for discoverability?▼

To create reusable AI skills, structure a `SKILL.md` file with YAML frontmatter for metadata and a Markdown body for instructions, ensuring fields like name, description, tags, and intent are defined for effective AI discovery.

What is the correct structure for a SKILL.md file?▼

A correct SKILL.md file consists of YAML frontmatter containing critical discovery metadata, followed by a Markdown body detailing the skill's instructions, naming conventions, and intent definition to ensure actionable AI workflows.

What are the best practices for writing YAML frontmatter to ensure skill discovery?▼

Best practices for YAML frontmatter involve clearly defining the name, description, tags, and intent fields to maximize AI discovery, while avoiding common mistakes in instruction clarity that hinder usability.

What is the step-by-step process to build and test a new skill template?▼

The step-by-step process involves identifying recurring task patterns, drafting the `SKILL.md` with proper metadata, defining clear instructions, and testing the integration to ensure the skill is actionable and discoverable.

Why do my custom AI workflow skills fail to trigger correctly?▼

Custom AI workflow skills often fail to trigger due to common mistakes in YAML frontmatter, such as poorly defined intent fields, unclear instructions, or missing discovery metadata like tags and descriptions.