Files
holocron/plugins/kyberforge
Defame1297 e3e43502db docs(kyberforge): add component-selection research closing the when-to-use gap
## Why

The existing kyberforge research covered skills vs agents (ADR-0010),
Copilot track selection, and agent scope hierarchy — but had no documented
basis for three practical decisions: when to use MCP servers vs skills vs
agents, when hooks are the right tool vs skills, and when bin/ is
appropriate vs scripts/ inside a skill directory. Without this, the
plugin-author and agent-author skills have no research backing for those
choices.

## Implementation Notes

Sourced from official Claude Code plugin docs (code.claude.com), official
GitHub Copilot CLI docs (docs.github.com), and the Copilot
customization-cheat-sheet and comparing-cli-features pages — the latter
containing the only official "putting it together" decision table across
components. Context7 MCP was the primary retrieval mechanism; web reads
deepened the hooks and bin/ content.

Three files produced:
- overview.md — mental model, component roles, cross-provider portability
- decision-guide.md — explicit decision tables for all three gaps,
  including anti-patterns and Copilot surface support matrix
- hooks.md — full lifecycle event reference, stdin/stdout schema,
  hookSpecificOutput per event, plugin scope restriction

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0147vXtL5sP6vorDdqXGJJU9
2026-06-28 20:49:05 +00:00
..

kyberforge

Skills and agents for creating, maintaining, and managing a Claude Code / Copilot CLI plugin marketplace.

Install

Claude Code:

claude plugin marketplace add <owner>/<repo>
claude plugin install kyberforge@<marketplace-name>

GitHub Copilot CLI:

copilot plugin marketplace add <owner>/<repo>
copilot plugin install kyberforge

Local (development):

# 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

Skills

Skill Description
skill-author Create or improve a skill from scratch, audit findings, or inline feedback
skill-audit Audit a skill directory against the agentskills.io spec and produce a findings report
agent-author Author an agent definition file
pc-author Create, add, remove, and configure .pre-commit-config.yaml
pc-run Install, run, autoupdate, and maintain the pre-commit setup
plugin-author Create, update, and release plugin scaffolds for the holocron marketplace
marketplace-author Add, remove, and update plugin entries in the holocron marketplace manifest

Author

Defame1297