Add Skill

VerifiedSafe

Guides the creation of a new skill for a Claude Code plugin by generating a SKILL.md file with frontmatter and instructions. Use when a user wants to extend a plugin's capabilities, prompting for required information like skill name, description, and behavior.

Sby Skills Guide Bot
DevelopmentIntermediate
806/2/2026
Claude Code
#skill-creation#plugin-development#claude-code#automation

Recommended for

Our review

Adds a new skill to a Claude Code plugin by following a structured process to create a SKILL.md file.

Strengths

  • Clear step-by-step guide for creating a skill
  • Includes best practices for descriptions and structure
  • Allows customization via frontmatter fields

Limitations

  • Only works within an existing plugin directory structure
  • Requires basic familiarity with the Claude Code plugin system
  • May need manual directory creation if not in the correct folder
When to use it

When creating a new skill for a Claude Code plugin.

When not to use it

When editing an existing skill or working with other coding assistants that don't support this plugin format.

Security analysis

Safe
Quality score85/100

This skill only creates a new skill file in a plugin directory by gathering user input and writing a markdown file. It does not execute any commands, access external resources, or handle sensitive data, posing no security threat.

No concerns found

Examples

Create metadata extraction skill
Add a new skill to my Claude Code plugin that extracts metadata from code files (like author, license, dependencies) and outputs a summary.
Add unit test generation skill
Create a skill called 'generate-tests' that automatically writes unit tests for the current Python file.
Fix typos skill
Add a skill to my plugin named 'fix-typos' that scans all markdown files in the project and corrects common spelling errors.

name: add-skill description: Add a new skill to an existing Claude Code plugin. Use when user wants to create a skill. user-invocable: true

Add Skill

You are adding a new skill to a Claude Code plugin. Follow these steps:

1. Gather Information

Ask the user for:

  • Plugin path (which plugin to add to, or current directory)
  • Skill name (lowercase, e.g., my-skill)
  • Description (when should Claude use this skill?)
  • User-invocable (show in / menu? default: true)
  • What should it do? (the actual instructions)

2. Create Skill Directory

<plugin>/skills/<skill-name>/
└── SKILL.md

3. Generate SKILL.md

Use this format:

---
name: <skill-name>
description: <description>. Use when <trigger condition>.
user-invocable: <true|false>
---

# <Skill Name>

<Instructions for Claude on how to execute this skill>

## Steps

1. <Step 1>
2. <Step 2>
3. ...

## Guidelines

- <Guideline 1>
- <Guideline 2>

4. Frontmatter Reference

Available frontmatter fields:

  • name (required): Skill identifier
  • description (required): When Claude should use this skill
  • user-invocable: Show in / menu (default: true)
  • disable-model-invocation: Block auto-invocation (default: false)
  • allowed-tools: Restrict which tools the skill can use

5. Best Practices

  • Description matters: Claude uses it to decide when to invoke
  • Be specific: Include trigger conditions ("Use when...")
  • Structure instructions: Use numbered steps, headers, examples
  • Keep it focused: One skill = one capability
Related skills