diff --git a/.agents/skills/plugin-create/META.md b/.agents/skills/create-plugin/META.md similarity index 100% rename from .agents/skills/plugin-create/META.md rename to .agents/skills/create-plugin/META.md diff --git a/.agents/skills/plugin-create/SKILL.md b/.agents/skills/create-plugin/SKILL.md similarity index 99% rename from .agents/skills/plugin-create/SKILL.md rename to .agents/skills/create-plugin/SKILL.md index d0363db..68b5165 100644 --- a/.agents/skills/plugin-create/SKILL.md +++ b/.agents/skills/create-plugin/SKILL.md @@ -1,5 +1,5 @@ --- -name: plugin-create +name: create-plugin description: > Use when the user wants to create a new plugin in the marketplace — scaffold the directory structure, generate plugin.json manifests for Claude Code and Copilot CLI, and register diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index ab381a8..19f4e76 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -8,6 +8,11 @@ "name": "hello-world", "description": "A minimal example plugin to validate marketplace scaffolding.", "source": "./plugins/hello-world" + }, + { + "name": "kyberforge", + "description": "Skills and agents for creating, maintaining, and managing a Claude Code / Copilot CLI plugin marketplace.", + "source": "./plugins/kyberforge" } ] } diff --git a/.github/plugin/marketplace.json b/.github/plugin/marketplace.json index 17d4d93..b0b8dc1 100644 --- a/.github/plugin/marketplace.json +++ b/.github/plugin/marketplace.json @@ -10,6 +10,11 @@ "name": "hello-world", "description": "A minimal example plugin to validate marketplace scaffolding.", "source": "./plugins/hello-world" + }, + { + "name": "kyberforge", + "description": "Skills and agents for creating, maintaining, and managing a Claude Code / Copilot CLI plugin marketplace.", + "source": "./plugins/kyberforge" } ] } diff --git a/plugins/kyberforge/.claude-plugin/plugin.json b/plugins/kyberforge/.claude-plugin/plugin.json new file mode 100644 index 0000000..8bc6b8d --- /dev/null +++ b/plugins/kyberforge/.claude-plugin/plugin.json @@ -0,0 +1,8 @@ +{ + "name": "kyberforge", + "displayName": "kyberforge", + "description": "Skills and agents for creating, maintaining, and managing a Claude Code / Copilot CLI plugin marketplace.", + "author": { "name": "Defame1297", "url": "https://git.dev.rkdr.net/Defame1297/" }, + "license": "MIT", + "keywords": [] +} diff --git a/plugins/kyberforge/.mcp.json b/plugins/kyberforge/.mcp.json new file mode 100644 index 0000000..da39e4f --- /dev/null +++ b/plugins/kyberforge/.mcp.json @@ -0,0 +1,3 @@ +{ + "mcpServers": {} +} diff --git a/plugins/kyberforge/README.md b/plugins/kyberforge/README.md new file mode 100644 index 0000000..05e3ce2 --- /dev/null +++ b/plugins/kyberforge/README.md @@ -0,0 +1,42 @@ +# kyberforge + +Skills and agents for creating, maintaining, and managing a Claude Code / Copilot CLI plugin marketplace. + +## Install + +**Claude Code:** + +```bash +claude plugin marketplace add / +claude plugin install kyberforge@ +``` + +**GitHub Copilot CLI:** + +```bash +copilot plugin marketplace add / +copilot plugin install kyberforge +``` + +**Local (development):** + +```bash +# Claude Code +claude --plugin-dir ./plugins/kyberforge + +# GitHub Copilot CLI +copilot plugin install ./plugins/kyberforge +``` + +## Contents + +| Component | Path | Description | +|---|---|---| +| Skills | `skills/` | Slash commands available after install | +| Agents | `agents/` | Role-based agents (`.md` for Claude, `.agent.md` for Copilot) | +| Hooks | `hooks/hooks.json` (Claude) / `hooks.json` (Copilot) | Event-triggered automation | +| MCP servers | `.mcp.json` | Model Context Protocol server definitions | + +## Author + +Defame1297 diff --git a/plugins/kyberforge/agents/README.md b/plugins/kyberforge/agents/README.md new file mode 100644 index 0000000..c59199a --- /dev/null +++ b/plugins/kyberforge/agents/README.md @@ -0,0 +1,13 @@ +# agents/ + +Agent definitions for this plugin. Each agent needs two files — one per tool: + +| File | Tool | Notes | +|---|---|---| +| `.md` | Claude Code | Frontmatter: `name`, `description`. No `tools:` field. | +| `.agent.md` | GitHub Copilot CLI | Frontmatter: `name`, `description`, `tools:` (array of permitted tool names). | + +The two files share the same system prompt body. Keep them in sync. + +Rename `PLUGIN_NAME.md` and `PLUGIN_NAME.agent.md` to your agent's name (kebab-case). +Add additional agent pairs as needed — one pair per agent. diff --git a/plugins/kyberforge/agents/kyberforge.agent.md b/plugins/kyberforge/agents/kyberforge.agent.md new file mode 100644 index 0000000..8fd6640 --- /dev/null +++ b/plugins/kyberforge/agents/kyberforge.agent.md @@ -0,0 +1,13 @@ +--- +name: kyberforge +description: Skills and agents for creating, maintaining, and managing a Claude Code / Copilot CLI plugin marketplace. +tools: + - read_file + - list_directory +--- + +Replace this with your agent's system prompt and instructions. + +This file is loaded by **GitHub Copilot CLI**. The `tools:` frontmatter field declares +which tools the agent can use — add or remove tools as needed. +For Claude Code, see `kyberforge.md`. diff --git a/plugins/kyberforge/agents/kyberforge.md b/plugins/kyberforge/agents/kyberforge.md new file mode 100644 index 0000000..9bdc572 --- /dev/null +++ b/plugins/kyberforge/agents/kyberforge.md @@ -0,0 +1,8 @@ +--- +name: kyberforge +description: Skills and agents for creating, maintaining, and managing a Claude Code / Copilot CLI plugin marketplace. +--- + +Replace this with your agent's system prompt and instructions. + +This file is loaded by **Claude Code**. For GitHub Copilot CLI, see `kyberforge.agent.md`. diff --git a/plugins/kyberforge/bin/README.md b/plugins/kyberforge/bin/README.md new file mode 100644 index 0000000..7399e35 --- /dev/null +++ b/plugins/kyberforge/bin/README.md @@ -0,0 +1,11 @@ +# bin/ + +**Claude Code only.** Executables placed here are added to PATH when the plugin is installed. + +Use this for CLI tools, helper scripts, or MCP server entry points bundled with the plugin. + +Reference files in this directory from `.mcp.json` or hooks using `${CLAUDE_PLUGIN_ROOT}/bin/`. +The `${CLAUDE_PLUGIN_ROOT}` variable resolves to the plugin's install cache path at runtime — +do not use relative paths from the repo root, as they will break after install. + +GitHub Copilot CLI does not support `bin/`. If you add executables here, they are Claude Code only. diff --git a/plugins/kyberforge/docs/README.md b/plugins/kyberforge/docs/README.md new file mode 100644 index 0000000..c2dc27a --- /dev/null +++ b/plugins/kyberforge/docs/README.md @@ -0,0 +1,7 @@ +# docs/ + +Plugin documentation. Place usage guides, reference material, and examples here. + +This directory is not read automatically by either Claude Code or GitHub Copilot CLI. +Reference specific files from your skill bodies or agent prompts when needed +(e.g. `See references/usage.md for examples`). diff --git a/plugins/kyberforge/hooks.json b/plugins/kyberforge/hooks.json new file mode 100644 index 0000000..b9820d5 --- /dev/null +++ b/plugins/kyberforge/hooks.json @@ -0,0 +1,3 @@ +{ + "hooks": [] +} diff --git a/plugins/kyberforge/hooks/README.md b/plugins/kyberforge/hooks/README.md new file mode 100644 index 0000000..76d8625 --- /dev/null +++ b/plugins/kyberforge/hooks/README.md @@ -0,0 +1,27 @@ +# hooks/ + +**Claude Code only.** Hook definitions that run in response to Claude Code events. + +The `hooks.json` in this directory is read by Claude Code. Structure: + +```json +{ + "hooks": { + "PostToolUse": [ + { + "matcher": "Bash", + "hooks": [ + { "type": "command", "command": "echo 'tool used'" } + ] + } + ] + } +} +``` + +Supported events: `PreToolUse`, `PostToolUse`, `Notification`, `Stop`. + +Use `${CLAUDE_PLUGIN_ROOT}` to reference scripts inside this plugin — the plugin runs +from a cache path after install, not its original repo location. + +For GitHub Copilot CLI hooks, see `hooks.json` at the plugin root. diff --git a/plugins/kyberforge/hooks/hooks.json b/plugins/kyberforge/hooks/hooks.json new file mode 100644 index 0000000..deffac9 --- /dev/null +++ b/plugins/kyberforge/hooks/hooks.json @@ -0,0 +1,3 @@ +{ + "hooks": {} +} diff --git a/plugins/kyberforge/plugin.json b/plugins/kyberforge/plugin.json new file mode 100644 index 0000000..41cd0ae --- /dev/null +++ b/plugins/kyberforge/plugin.json @@ -0,0 +1,11 @@ +{ + "name": "kyberforge", + "description": "Skills and agents for creating, maintaining, and managing a Claude Code / Copilot CLI plugin marketplace.", + "author": { "name": "Defame1297", "email": "defame1297@rkdr.net" }, + "license": "MIT", + "keywords": [], + "agents": "agents/", + "skills": ["skills/"], + "hooks": "hooks.json", + "mcpServers": ".mcp.json" +} diff --git a/plugins/kyberforge/skills/README.md b/plugins/kyberforge/skills/README.md new file mode 100644 index 0000000..20d05b9 --- /dev/null +++ b/plugins/kyberforge/skills/README.md @@ -0,0 +1,18 @@ +# skills/ + +Skills for this plugin. Each skill lives in its own subdirectory: + +``` +skills/ + / + SKILL.md # required — frontmatter + skill body + META.md # required — provenance and audit fields + references/ # optional — on-demand reference docs + scripts/ # optional — executable helper scripts + assets/ # optional — templates, data files, lookup tables +``` + +**Shared** — both Claude Code and GitHub Copilot CLI read `skills//SKILL.md`. + +To add a skill, run `/write-skill` in a Claude Code session. Do not write SKILL.md by hand +without following the authoring standard — trigger descriptions and self-checks are required.