mirror of https://github.com/anthropics/claude-plugins-official.git synced 2026-03-17 22:43:09 +00:00

Files

Henry Shi 58ad5cbb02 docs(plugin-dev): deprecate commands/ in favor of skills/<name>/SKILL.md

P0 follow-up for EA-471. Updates plugin-dev teaching materials to stop
recommending the commands/ directory layout for new plugins:

- command-development/SKILL.md: add legacy banner at top pointing to
  skills/ format
- create-plugin.md: update scaffolding to create skills/<name>/SKILL.md
  instead of commands/; mark commands/ as acceptable legacy alternative;
  update all examples, tables, and testing instructions
- example-plugin: migrate example-command to skills/example-command/SKILL.md;
  keep commands/example-command.md with a legacy-format note; update README
  to reflect new preferred structure

Both formats remain loaded identically — this is a documentation change only.

Refs: anthropics/apps#26827

2026-03-08 15:56:20 -07:00

1.2 KiB

Raw Blame History

name, description, argument-hint, allowed-tools

name

description

argument-hint

allowed-tools

example-command

An example user-invoked skill that demonstrates frontmatter options and the skills/<name>/SKILL.md layout

<required-arg> [optional-arg]

Read

Glob

Grep

Bash

Example Command (Skill Format)

This demonstrates the skills/<name>/SKILL.md layout for user-invoked slash commands. It is functionally identical to the legacy commands/example-command.md format — both are loaded the same way; only the file layout differs.

Arguments

The user invoked this with: $ARGUMENTS

Instructions

When this skill is invoked:

Parse the arguments provided by the user
Perform the requested action using allowed tools
Report results back to the user

Frontmatter Options Reference

Skills in this layout support these frontmatter fields:

name: Skill identifier (matches directory name)
description: Short description shown in /help
argument-hint: Hints for command arguments shown to user
allowed-tools: Pre-approved tools for this skill (reduces permission prompts)
model: Override the model (e.g., "haiku", "sonnet", "opus")

Example Usage

/example-command my-argument
/example-command arg1 arg2

1.2 KiB Raw Blame History