Bundles Forge

中文

A toolkit for building bundle-plugins — AI coding plugins organized around collaborative skill workflows — across Claude Code, Cursor, Codex, OpenCode, Gemini CLI, and OpenClaw.

What is a Bundle-Plugin?

A single skill (SKILL.md) does one thing — an AI agent discovers it by its description field and loads it on demand. A bundle-plugin takes this further: multiple skills reference each other and form a workflow, where one skill's output feeds the next.

graph LR
    A["Skill A"] -->|output feeds| B["Skill B"]
    B -->|output feeds| C["Skill C"]
    C -->|validates| A

bundles-forge itself is a bundle-plugin — blueprinting produces a design, scaffolding generates a project from it, auditing validates the result, and optimizing iterates on issues found.

If your plugin has 3+ skills that form a workflow, you're building a bundle-plugin. This toolkit gives you scaffolding, quality gates, and multi-platform publishing for that pattern.

Quick Start

Install (Claude Code)

1. Add the marketplace:

   /plugin marketplace add OdradekAI/bundles-forge
   

2. Install the plugin:

   /plugin install bundles-forge@bundles-forge-dev
   

Or clone locally for development:

git clone https://github.com/OdradekAI/bundles-forge.git
cd bundles-forge

# Add your local marketplace
/plugin marketplace add ./

# Install the plugin
/plugin install bundles-forge@bundles-forge-dev

Other platforms: see Platform Support below.

Path A: Build a New Bundle-Plugin

bundles-forge:blueprinting

This starts a structured interview to design your project — scope, platform targets, skill decomposition. When the design is ready, the agent automatically chains into scaffolding (project generation) and then authoring (SKILL.md writing).

Path B: Audit an Existing Project

cd your-bundle-plugin-project
bundles-forge:auditing

Runs a 10-category quality assessment with pattern-based security checks across 7 file categories.

Concepts

Concept	What it is
Skill	Atomic capability unit (SKILL.md) — discovered by description, loaded on demand
Plugin	Packaging/distribution unit — bundles skills, agents, hooks, and more
Subagent	Isolated AI assistant for delegated tasks with its own context window
Hook	Shell/HTTP/LLM/Agent action that fires automatically on lifecycle events
MCP	Open standard connecting Claude to external tools and data sources

Full explanations, design decisions, and architecture diagrams → Concepts Guide

Skills

The 8 skills cover the full lifecycle of a bundle-plugin project, organized into two layers:

• Orchestrators (blueprinting, optimizing, releasing) — diagnose, decide, and delegate. They chain multiple skills together to accomplish multi-step goals.
• Executors (scaffolding, authoring, auditing, testing) — single-responsibility workers. They can be invoked directly by users or dispatched by orchestrators.