create-skill

Guide SKILL.md authoring with YAML frontmatter and Markdown structure.

Updated Jan 7, 2026
One-click install
npx skills add https://github.com/lbussell/agent-skills --skill create-skill-lbussell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/lbussell/agent-skills/tree/main/skills/create-skill
Command: npx skills add https://github.com/lbussell/agent-skills --skill create-skill-lbussell

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide and best practices for creating, structuring, and documenting agent skills, ensuring clarity, efficiency, and maintainability.

Core Features & Use Cases

  • SKILL.md Structure: Defines the essential YAML frontmatter and Markdown body for skill definitions.
  • Best Practices: Offers guidance on conciseness, specificity, progressive disclosure, and avoiding common anti-patterns.
  • Script Integration: Details how to incorporate executable scripts for complex operations, including error handling and dependency management.
  • Use Case: When starting a new agent skill, use this guide to ensure your SKILL.md is well-formed, your instructions are clear, and you leverage scripts effectively for robust functionality.

Quick Start

Follow the guidance in this skill to create a new SKILL.md file for your agent.

Frequently Asked Questions about create-skill

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

FAQPage Schema
How do I structure a SKILL.md file for agent development?

Structure a SKILL.md file by defining essential YAML frontmatter and a Markdown body. This format ensures your agent skill definitions have the clarity and efficiency needed for maintainability.

What are the best practices for writing agent skills?

Best practices for writing agent skills include maintaining conciseness, ensuring specificity, and using progressive disclosure. These principles help you avoid common anti-patterns and keep instructions clear.

How do I integrate executable scripts into an agent skill?

Integrate executable scripts into your agent skill by following guidelines for complex operations, error handling, and dependency management. This approach ensures robust functionality within the skills framework.

When do I need progressive disclosure in skill authoring?

You need progressive disclosure in skill authoring when structuring complex workflows. It allows you to layer instructions, preventing the SKILL.md file from overwhelming the agent while retaining necessary context.

Does this skill authoring guide help with dependency management?

Yes, this skill authoring guide details dependency management and error handling for executable scripts. These instructions ensure your robust skill development handles complex operations without failing unexpectedly.

Why are my agent skill instructions being ignored or misinterpreted?

Agent skill instructions are often ignored due to a lack of conciseness and specificity. Following core principles for clarity and avoiding common anti-patterns in your SKILL.md ensures the agent processes commands correctly.