Skill Creation

Guide for creating new reusable skills. Defines structure, Markdown format, and best practices for documenting AI workflows.

Sby Skills Guide Bot
ProductivityIntermediate0 views0 installs2/28/2026
Claude Code
skill-creationdocumentationworkflow-automationmarkdown-format

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