Why can't I define agents directly in plugin.json?

Claude Code requires agents and commands to be separate markdown files for better organization and documentation; the plugin.json file should only contain an array of paths to these files.

What is the difference between a command and an agent?

Commands are CLI-like utilities triggered by a slash (e.g., /review) for specific tasks, while agents are autonomous assistants with specific roles triggered by @ (e.g., @architect).

Does every command need YAML frontmatter?

Yes, every command and agent file must start with YAML frontmatter containing 'name' and 'description' fields to be correctly recognized by the Claude Code environment.

Can I use bash scripts within these commands?

Yes, but it is recommended to keep bash operations simple. Avoid complex pipes or long chains to ensure the command remains reliable and easy to debug.

Agents & Commands Creator

Name: Agents & Commands Creator
Author: karchtho

bykarchtho

Developer Tools

Standardizes the creation of Claude Code agents and commands using proper markdown structure and YAML configuration.

About

This skill provides a comprehensive framework and validation guide for developers building Claude Code plugins. It ensures that slash commands and autonomous agents are correctly defined as standalone markdown files with the required YAML frontmatter, preventing common configuration errors in plugin.json. By offering templates and best practices for both CLI-style commands and specialized AI agents, it helps developers create more reliable, well-documented, and interoperable Claude Code extensions while avoiding common pitfalls like inline JSON definitions.

Key Features

Markdown structure and documentation best practices
Common mistake identification and troubleshooting
Standardized templates for slash commands and agents
Correct plugin.json array mapping guidance
0 GitHub stars
YAML frontmatter validation and requirement mapping

Use Cases

Developing new slash commands for custom Claude Code plugins
Creating specialized autonomous agents with distinct personas and roles
Restructuring existing plugins to follow standardized Claude Code file patterns

About

Key Features

Markdown structure and documentation best practices
Common mistake identification and troubleshooting
Standardized templates for slash commands and agents
Correct plugin.json array mapping guidance
0 GitHub stars
YAML frontmatter validation and requirement mapping

Use Cases

Developing new slash commands for custom Claude Code plugins
Creating specialized autonomous agents with distinct personas and roles
Restructuring existing plugins to follow standardized Claude Code file patterns