claude-code-demo-plugins

Claude Code Plugins Demo

Demo implementation of Claude Code plugin system

Overview

Demo repository showing implementation examples of Claude Code plugins

• Slash command implementation
• Sub-agent implementation
• Hook implementation
• Resource file implementation
• Project configuration using plugins

Directory Structure

claude-code-plugins-demo/
├── .claude-plugin/
│   └── marketplace.json          # Plugin marketplace configuration
├── plugins/                       # Plugin definitions directory
│   ├── demo-plugin1/             # Demo plugin 1
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json       # Plugin metadata
│   │   ├── agents/               # Sub-agent definitions
│   │   │   └── greeting-translation.md
│   │   ├── commands/             # Slash command definitions
│   │   │   ├── greeting.md
│   │   │   └── greeting-translation.md
│   │   ├── hooks/                # Hook definitions
│   │   │   ├── hooks.json
│   │   │   └── greeting.sh
│   │   ├── resources/            # Resource files
│   │   │   └── greeting.md
│   │   └── .mcp.json             # MCP server configuration (within plugin)
│   └── demo-plugin2/             # Demo plugin 2
│       └── hooks/
│           ├── hooks.json
│           └── greeting.sh
├── plugin-client-demo/           # Demo project using plugins
│   ├── .mcp.json                 # MCP server configuration (project root)
│   └── .claude/
│       └── README.md
├── LICENSE
└── README.md                     # This file

Plugin Features Demo

demo-plugin1

Demo plugin implementing major Claude Code plugin features

Features

Slash Commands

• /greeting: Returns a simple greeting
• /greeting-translation: Translates time-based greetings into 4 random languages

Sub-agents

• greeting-translation: Multilingual greeting translation agent (with country/region info)

Hooks

• SessionStart: Displays greeting message at session start
• Stop: Shows macOS notification at session stop

Resources

• greeting.md: Greeting definition

demo-plugin2

Second plugin implementation example

⚠️ Note: This plugin is not registered in .claude-plugin/marketplace.json

Features

Hooks

• SessionStart: Executes custom script (greeting.sh) at session start
• Stop: Shows macOS notification at session stop (Plugin2 identifier)

Important Notes

Environment Variable Limitation

When using plugins from remote repositories, environment variables in .mcp.json within the plugin may not be resolved

Issue: Environment variables like ${GITHUB_PERSONAL_ACCESS_TOKEN} in plugin's .mcp.json may not be accessible

Solution: Place configuration files using environment variables (.mcp.json) at the project root

See plugin-client-demo/.claude/README.md for details

Variable Usage

The following special variables are available within plugins

• ${CLAUDE_PLUGIN_ROOT}: Plugin root directory path

Example:

@${CLAUDE_PLUGIN_ROOT}/resources/greeting.md

About Each Demo

demo-plugin1

Plugin implementing various features

demo-plugin2

Plugin implementing hook functionality

plugin-client-demo

Implementation example of a project using plugins

Related Links

• Claude Code Documentation
• Claude Code Plugins Guide