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

0•

Herramientas para Desarrolladores

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

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.

Características Principales

01Markdown structure and documentation best practices

02Common mistake identification and troubleshooting

03Standardized templates for slash commands and agents

04Correct plugin.json array mapping guidance

050 GitHub stars

06YAML frontmatter validation and requirement mapping

Casos de Uso

01Developing new slash commands for custom Claude Code plugins

02Creating specialized autonomous agents with distinct personas and roles

03Restructuring existing plugins to follow standardized Claude Code file patterns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add karchtho/my-claude-marketplace agents-commands-creator

For use in Claude.ai and ChatGPT

Download Skill