claude-code-plugins: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

This is emdashcodes-claude-code-plugins - Em's personal Claude Code plugin marketplace featuring specialized plugins for development workflows, productivity, and AI-powered tools.

Architecture

Plugin Structure

emdashcodes/
├── .claude-plugin/
│   └── marketplace.json          # Plugin registry
├── plugins/
│   └── plugin-name/
│       ├── CHANGELOG.md           # Version history
│       ├── commands/              # Slash commands (optional)
│       │   └── command.md
│       ├── skills/                # Skills with SKILL.md files (optional)
│       │   └── skill-name/
│       │       └── SKILL.md
│       └── scripts/               # Helper scripts (optional)
└── CLAUDE.md                      # This file

Skills Specification

All skills must have a SKILL.md file with YAML frontmatter:

• Required frontmatter fields:
  • name - hyphen-case, lowercase alphanumeric + hyphens
  • description - when Claude should use this skill
• Optional frontmatter fields:
  • license
  • metadata - custom key-value pairs
• Body: Markdown instructions, examples, and guidelines

Using This Marketplace

Adding to Claude Code

/plugin marketplace add emdashcodes/claude-code-plugins

Installing Plugins

# Browse available plugins
/plugin

# Install specific plugin
/plugin install <plugin-name>@emdashcodes-claude-code-plugins

Creating New Plugins

1. Create plugin directory under plugins/:

   mkdir -p plugins/my-plugin/{skills,commands,scripts}
   

2. Add CHANGELOG.md:

   # Changelog
   
   ## [1.0.0] - YYYY-MM-DD
   
   ### Added
   - Initial release
   

3. Create skills/commands as needed

4. Register in marketplace.json:

   {
     "name": "my-plugin",
     "source": "./plugins/my-plugin",
     "description": "Plugin description",
     "version": "1.0.0",
     "author": { "name": "Em" },
     "repository": "https://github.com/emdashcodes/claude-code-plugins",
     "license": "MIT",
     "keywords": ["keyword1", "keyword2"],
     "category": "productivity",
     "strict": true,
     "skills": ["./skills/my-skill"],
     "commands": ["./commands/my-command.md"]
   }