skill-generator

Generate structured SKILL.md documentation with YAML frontmatter and resource directories.

12|2|Updated May 29, 2025
One-click install
npx skills add https://github.com/sorryhyun/DiPeO --skill skill-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-generator
Source: https://github.com/sorryhyun/DiPeO/tree/main/.claude/skills/generate-skill
Command: npx skills add https://github.com/sorryhyun/DiPeO --skill skill-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Creating new Claude Skills with proper structure, effective descriptions, and adherence to best practices can be time-consuming and require familiarity with the skill definition. This skill automates the generation process, ensuring your new skills are well-formed, discoverable, and ready for use from the start.

Core Features & Use Cases

  • Guided Skill Creation: Interactively asks targeted questions to understand the skill's purpose, concrete use cases, and natural language triggers, ensuring a highly effective SKILL.md.
  • Best Practice Enforcement: Generates SKILL.md with concise, outcome-oriented descriptions, uses hyphen-case for names, and applies appropriate structural templates (workflow, task, reference, or capabilities-based).
  • Resource Recommendation: Intelligently suggests optional scripts/, references/, and assets/ directories based on the skill's complexity and intended use, promoting organized development.
  • Use Case: You want to create a new skill for "managing project TODO lists." This skill will guide you through defining its purpose, generate the SKILL.md file with the correct YAML frontmatter and structure, and even suggest relevant resources, saving you from manual setup and formatting.

Quick Start

SKILL.md template (keep it concise - aim for <200 lines):

---

name: [hyphen-case-name]

description: [What it does + when to use + trigger keywords]

---

# [Skill Title]

[1-2 sentence overview]

## [Main Section]

[Core instructions - keep focused]

Frequently Asked Questions about skill-generator

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

FAQPage Schema
How do I create a new Claude skill with proper SKILL.md structure?

Use guided prompts to define your skill's purpose, use cases, and trigger keywords, then generate a properly formatted SKILL.md file with YAML frontmatter, concise descriptions, and organized resource directories (scripts/, references/, assets/) following best practices for discoverability and adherence to skill templates.

What should a SKILL.md file include to ensure my skill is discoverable?

A well-formed SKILL.md requires hyphen-case naming, outcome-oriented descriptions under 200 lines, YAML frontmatter with metadata, natural language trigger keywords, and structural templates matching your skill type: workflow-based, task-based, reference/guidelines, or capabilities-based formats.

Can this help me structure documentation for an AI agent or automation tool?

Yes. The skill generator applies best practices for documenting automation tools and AI agents, ensuring clear trigger keywords, concrete use cases, and resource organization that make your skill easy to discover and use within Claude Code.

What are the main differences between skill templates: workflow, task, reference, and capabilities?

Workflow skills guide multi-step processes; task skills handle single focused actions; reference skills provide guidelines and best practices; capabilities skills document feature sets. The generator recommends the right template based on your skill's purpose and suggests matching resource structures.

Do I need to manually organize scripts, references, and assets directories?

The skill generator intelligently recommends optional directories based on complexity and intended use, suggesting which resources belong in scripts/, references/, or assets/—saving time and promoting consistent skill organization without manual guesswork.

What best practices should I follow when defining trigger keywords for my skill?

Trigger keywords should reflect natural language queries users type when they need your skill's functionality. The generator guides you to identify effective keywords aligned with your skill's core task, ensuring high discoverability in search without over-specifying or using internal jargon.