holocron/plugins/hello-world

hello-world

Complete scaffold plugin for the holocron marketplace. Every cross-compatible component is included with a working stub. Copy this directory, rename it, and replace the stubs with your actual content.

Directory layout

hello-world/
├── plugin.json                    # Copilot CLI manifest — declares component paths
├── .claude-plugin/
│   └── plugin.json               # Claude Code manifest — no component paths (uses defaults)
├── skills/
│   └── hello-world/
│       └── SKILL.md              # ✅ identical for both tools
├── agents/
│   ├── hello-world.md            # Claude Code agent (no frontmatter)
│   └── hello-world.agent.md     # Copilot CLI agent (YAML frontmatter + tools:)
├── hooks/
│   └── hooks.json               # Claude Code hooks (PostToolUse / PreToolUse events)
├── hooks.json                   # Copilot CLI hooks (session_start / session_end events)
├── .mcp.json                    # ✅ MCP server config — identical for both tools
└── README.md

Cross-compatibility notes

Component	Claude Code path	Copilot CLI path	Portable?
Plugin manifest	.claude-plugin/plugin.json	plugin.json at root	Ship both
Skills	skills/<name>/SKILL.md	skills/<name>/SKILL.md	✅ Identical
Agents	agents/<name>.md	agents/<name>.agent.md	Ship both
Hooks	hooks/hooks.json	hooks.json at root	Ship both
MCP servers	.mcp.json at root	.mcp.json at root	✅ Identical

Install via marketplace

# Claude Code
claude plugin marketplace add <owner>/ai-development
claude plugin install hello-world@holocron

# GitHub Copilot CLI
copilot plugin marketplace add <owner>/ai-development
copilot plugin install hello-world

Local dev install

# Claude Code
claude --plugin-dir ./plugins/hello-world

# GitHub Copilot CLI
copilot plugin install ./plugins/hello-world

Validate (Claude Code)

claude plugin validate ./plugins/hello-world

Copilot CLI has no validate command — run copilot plugin install ./plugins/hello-world and check that /skills list and /agent surface the expected entries.

Creating a new plugin from this scaffold

1. Copy plugins/hello-world/ → plugins/<your-plugin-name>/
2. Update name in both plugin.json files
3. Replace skills/hello-world/SKILL.md with your skill(s)
4. Replace or remove agents/ files — only include if your plugin ships an agent
5. Replace or remove hooks/ files — only include if your plugin reacts to events
6. Replace or remove .mcp.json — only include if your plugin ships an MCP server
7. Add the new plugin to .claude-plugin/marketplace.json
8. Run claude plugin validate ./plugins/<your-plugin-name>