Skill Creation

VerifiedSafe

Guide for creating new reusable skills. Structure your instructions, documentation and examples in a standardized format.

Sby Skills Guide Bot
DevelopmentBeginner
206/2/2026
Claude Code
#skill-creation#meta-skill#markdown#workflow

Recommended for

Our review

Creates a new reusable skill for Claude Code by following a structured template.

Strengths

  • Step-by-step instructions for well-organized skill creation
  • Encourages including documentation and examples
  • Uses simple, readable Markdown format

Limitations

  • Requires the user to know what they want to automate
  • Does not automatically handle complex dependencies
When to use it

When you want to turn a repetitive task into a reusable skill for Claude Code.

When not to use it

If the task is already well covered by an existing skill or is too specific to be reused.

Security analysis

Safe
Quality score85/100

The skill only uses file_write to create markdown files in a designated folder. It does not invoke any shell commands, network requests, or external tools that could cause harm.

No concerns found

Examples

Commit message skill
Create a skill that generates commit messages from git diffs.
Code review skill
Create a skill for reviewing pull requests with a checklist.

name: "Skill Creating" description: "Used to create a new skill. Used when a user wants to create a new skill " version: "1.0.0" dependencies: ["context7", "mcp-api", "python>=3.8"] allowed-tools: ["file_write"]

Create Skill

Instructions

When requested to create a new skill

Create Skill

Instructions

When requested to create a new skill, follow these steps:

  1. Create a new folder in .claude/skills with the skill name xyz.md (make name gerund form)
  2. Take the requested input to turn into a re-usable skill
  3. Be sure to have the description field be very clear on what it does and how to use it - 2-4 sentences max
  4. Store documentation and sample inputs/outputs in a new sub-folder there resources/ if they exceed several lines or will be referenced for depth.
  5. Generate minimal, clear, actionable Markdown instructions as the primary workflow guide.
  6. If code or scripts are needed, place them in the skill folder and reference their purpose in this file.

##Template:


name: my-skill-name description: A clear description of what this skill does and when to use it

My Skill Name

[Add your instructions here that Claude will follow when this skill is active]

Examples

  • Example usage 1
  • Example usage 2

Guidelines

  • Guideline 1
  • Guideline 2

Examples

skill.md

name: Generating Commit Messages description: Generates clear commit messages from git diffs. Use when writing commit messages or reviewing staged changes.

Generating Commit Messages

Instructions

  1. Run git diff --staged to see changes
  2. I'll suggest a commit message with:
    • Summary under 50 characters
    • Detailed description
    • Affected components

Best practices

  • Use present tense
  • Explain what and why, not how

References

Related skills