ScriptedAlchemy

Agent Bundle — AI skill for Claude Code

AI community

Build portable AI-agent plugin bundles for Codex, Claude Code, and Agent Plugins.

How to install Agent Bundle

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ScriptedAlchemy/agent-bundle and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agent Bundle does

Build portable AI-agent plugin bundles for Codex, Claude Code, and Agent Plugins.

Alternatives in AI

Claude Design Skill — A portable Claude Skill that turns Claude into an expert designer for HTML artifacts — decks, landing pages, p 184 ★
Odysseus Portable — A unified, 100% self-contained, open-source, and offline-first local AI agent workspace 122 ★
Pragma — Build portable agent teams across models and harnesses, with shared memory, skills, tools, and workflows — the 113 ★

README

agent-bundle

`agent-bundle` compiles one Agent Bundle project into portable, Codex, and Claude Code artifacts. It discovers skills, validates a typed configuration, bundles local JavaScript/TypeScript entry points, and writes the host-specific metadata needed by each selected target.

It requires Node.js 22.19 or later.

Quick start

Install the package in the project that owns the plugin, describe the plugin once, and compile it for every host you target:

npm install --save-dev agent-bundle

// agent-bundle.config.ts
import { defineConfig } from 'agent-bundle/config';

export default defineConfig({
  plugin: { name: 'my-plugin', version: '0.1.0', description: 'One bundle, every agent host.' },
  targets: ['plugin'],
  skills: ['skills/*'],
  hooks: { sessionStart: { handler: './src/session-start.ts' } },
  mcp: { servers: { tools: { entry: './src/mcp.ts' } } },
});

agent-bundle dev --root .              # local workbench with live rebuilds
agent-bundle build --root . --output dist

`targets: ['plugin']` emits one **agent plugin bundle** at `dist/plugin/` that installs into multiple hosts from the same root: `.claude-plugin/` (Claude Code), `.codex-plugin/` (Codex), and `.cursor-plugin/` (Cursor) manifests over shared `skills/`, `hooks/`, `mcp/`, `scripts/`, and `assets/` directories, plus a generated `AGENTS.md` install matrix. Hooks compile once into host-detecting wrappers that serve Claude Code and Codex; Cursor consumes the skills and MCP servers. Per-host artifacts remain available as `claude`, `codex`, and `portable` targets when a host-specific layout is required.

Install and build

agent-bundle dev --root .
agent-bundle build --root . --output artifact

The implemented commands are:

agent-bundle build validates source and writes an artifact.
agent-bundle inspect displays the normalized source configuration and target plans.
agent-bundle validate validates source; `agent-bundle validate --artif