ai-builder-kit

imagevalidate imageLicense: Apache-2.0

A collection of skills, plugins, and hooks for AI coding agents. Works as a Claude Code plugin marketplace, a Codex plugin marketplace, and a plain skills repo for npx skills. Every skill is a portable SKILL.md, so the same folder works in Claude Code, Codex, and any agent that follows the Agent Skills spec.

flowchart LR
  S["skills/*/SKILL.md<br/>one folder per skill"]
  H["plugins/hlx-admin-api-executor-guarded<br/>PreToolUse hook"]
  S --> N["npx skills<br/>any agent, one skill at a time"]
  S --> C["Claude Code marketplace<br/>one plugin per skill + a bundle"]
  S --> X["Codex marketplace<br/>the bundle"]
  S -. "symlink" .-> H --> C

One source of truth: every channel reads the same skills/ folder, and the hook plugin pulls its skill in through a symlink instead of a copy.

Available Skills

Available Plugins

Getting Started

Pick one path. They all read the same skills/ folder.

Option A: npx skills (any agent, one skill at a time)

npx skills add jackzhaojin/ai-builder-kit --list                       # see what is available
npx skills add jackzhaojin/ai-builder-kit --skill excalidraw            # into this project
npx skills add jackzhaojin/ai-builder-kit --skill excalidraw -g -a claude-code codex   # global, Claude Code + Codex
npx skills add jackzhaojin/ai-builder-kit -g -y                         # everything, global
npx skills update -g -y                                                 # pull updates later

Codex and OpenCode read ~/.agents/skills directly, so a global install shows up in both with no extra step.

Option B: Claude Code plugin marketplace

Every skill is a plugin of the same name, and ai-builder-kit is a bundle of all of them. Install the bundle or individual skills, not both, or the skills load twice.

claude plugin marketplace add jackzhaojin/ai-builder-kit
claude plugin install excalidraw@ai-builder-kit                # one skill
claude plugin install ai-builder-kit@ai-builder-kit            # every skill
claude plugin install hlx-admin-api-executor-guarded@ai-builder-kit   # skill + enforced hook

Or in one step from a session (Claude Code 2.1.275 or later): /plugin install excalidraw --marketplace jackzhaojin/ai-builder-kit. The same marketplace can be pinned for a team in a project's .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "ai-builder-kit": {
      "source": { "source": "github", "repo": "jackzhaojin/ai-builder-kit" }
    }
  }
}

Option C: Codex and the ChatGPT desktop app

The repo ships .agents/plugins/marketplace.json with one plugin, ai-builder-kit, that bundles all skills (manifest in .codex-plugin/plugin.json).

codex plugin marketplace add jackzhaojin/ai-builder-kit

Then restart the ChatGPT desktop app, open the Plugins Directory, choose the AI Builder Kit marketplace, and install. For single skills in Codex, use Option A with -a codex.

Keeping it up to date

Skill plugins carry no pinned version, so Claude Code keys updates on the commit SHA and every push to main that touches a skill is an update. The guarded plugin pins a version in its plugin.json and updates when that number moves. Pull updates with whichever path you installed from:

Repo layout

Developing

Rules for adding or changing a skill live in CLAUDE.md (AGENTS.md is a symlink to it, so Codex reads the same rules). Before committing:

node scripts/check-repo.mjs
claude plugin validate .claude-plugin/marketplace.json --strict
claude plugin validate skills --strict

License

Apache-2.0