---
name: gucky/skill-bundler
source: https://app.decimal.ai/s/gucky-skill-bundler@1/SKILL.md
source_sha256: bce9148aa76d
---

# Skill Bundler

Create or review Skill Bundles. A Skill Bundle does not provide domain capabilities itself; only the bundled Sub-Skills do the real work.

## Core Rules

- Use `skill_bundle_template.md` as the authoritative template for the generated bundle `SKILL.md`.
- Keep the generated bundle `SKILL.md` short: runtime rule, dispatch map, and essential bundle-specific notes only.
- In the generated dispatch map, list every Sub-Skill as its own bullet; do not group multiple Sub-Skills into one dispatch entry.
- Do not copy Sub-Skill content into the generated bundle `SKILL.md`.
- Copy source skill folders whole, then rename only each copied `SKILL.md` to `SUB_SKILL.md`.
- Preserve copied files, assets, scripts, references, notices, and licenses unless the user explicitly asks for cleanup.
- For Git-backed source skills, record the source repository and resolved base commit in `bundled-skills/manifest.json`.

## Workflow

1. Confirm the bundle name, folder slug, source skills, and bundle icon.
2. Inspect each source skill to understand its trigger, purpose, resources, and license/source notes.
3. Create the bundle folder with `SKILL.md`, `agents/openai.yaml`, and `bundled-skills/`.
4. Copy each source skill into `bundled-skills/<subskill-slug>/`.
5. Rename each copied top-level `SKILL.md` to `SUB_SKILL.md`; do not leave discoverable `SKILL.md` files below `bundled-skills/`.
6. Fill `skill_bundle_template.md` to write the generated bundle `SKILL.md`.
7. Add a compact `bundled-skills/index.json` for runtime routing when the dispatch map is not enough.
8. Add a `bundled-skills/manifest.json` only for review, audit, source, license, and update context. For every Git-backed source, include at least its repository URL and resolved base commit; include tag, branch, or source path when known.
9. Validate the bundle before handing it back.

## Generated Bundle Shape

```text
<bundle-slug>/
  SKILL.md
  agents/openai.yaml
  bundled-skills/
    index.json
    manifest.json
    <subskill-slug>/
      SUB_SKILL.md
      ...
```

## Template Use

Open `skill_bundle_template.md` before writing a generated bundle `SKILL.md`. Replace placeholders, remove unused optional notes, and keep the result shorter than the source skills it routes to.

The generated dispatch map should help choose likely Sub-Skills without opening every copied folder. Put detailed capability metadata in `index.json`, not in the top-level bundle `SKILL.md`.

## Validation

- `find bundled-skills -name SKILL.md` returns no files.
- Every Sub-Skill path named by the generated bundle exists.
- Every Sub-Skill has exactly one dispatch-map bullet.
- `index.json` is valid JSON and points to existing `SUB_SKILL.md` files.
- `manifest.json`, if present, is valid JSON and is not required for normal runtime use.
- Git-backed sources in `manifest.json` include a repository URL and resolved base commit.
- `agents/openai.yaml` exists and describes the generated bundle, not this Skill Bundler.
- The generated bundle `SKILL.md` says to load only relevant Sub-Skills after the task need is clear.
- The generated bundle `SKILL.md` stays compact and does not duplicate Sub-Skill instructions.