ai-persona

ai-persona

A marketplace of portable agent plugins — skills, hooks, and rules for AI coding agents, version-controlled and shareable across tools and machines.

---

Plugins

Plugin	Description
k8s	Kubernetes development — operators, CRDs, controllers, client-go, envtest

See each plugin's README for full installation instructions.

---

Install

Claude Code (Plugin — recommended)

claude plugin marketplace add zarcen/ai-persona
claude plugin install <plugin-name>@ai-persona

Claude Code (manual)

gh repo clone zarcen/ai-persona /tmp/ai-persona
cp -r /tmp/ai-persona/plugins/<plugin-name>/skills/<skill-name> .claude/skills/

Cursor (Marketplace Plugin — recommended)

Install via the Cursor Marketplace using .cursor-plugin/marketplace.json in this repo.

Cursor (manual)

gh repo clone zarcen/ai-persona /tmp/ai-persona
cp -r /tmp/ai-persona/plugins/<plugin-name>/skills/<skill-name> .cursor/skills/

Codex

git clone https://github.com/zarcen/ai-persona.git ~/.codex/ai-persona
mkdir -p ~/.agents/skills
ln -s ~/.codex/ai-persona/plugins/<plugin-name>/skills ~/.agents/skills/<plugin-name>

---

Tool Config

Per-tool config files symlinked from this repo — git pull on any machine instantly applies changes.

git clone https://github.com/zarcen/ai-persona.git
sh ai-persona/claude-config/install.sh   # Claude Code statusline

Tool	Config	Description
Claude Code	statusline	Custom statusline: working directory, model name, context window usage

---

Repo Structure

ai-persona/
├── .claude-plugin/              # GENERATED — Claude Code marketplace catalog
│   └── marketplace.json
├── .cursor-plugin/              # GENERATED — Cursor marketplace catalog
│   └── marketplace.json
├── plugins/                     # SOURCE — author plugins here
│   └── <plugin-name>/
│       ├── .claude-plugin/plugin.json   # Claude Code manifest (authored)
│       ├── .cursor-plugin/plugin.json   # Cursor marketplace manifest (authored)
│       ├── assets/logo.svg              # symlink to repo root logo.svg
│       ├── README.md                    # Plugin install guide
│       ├── skills/
│       │   └── <skill-name>/
│       │       ├── SKILL.md             # frontmatter + instructions
│       │       └── references/          # deep-dive docs (loaded on demand)
│       ├── hooks/                       # optional
│       └── rules/                       # optional
├── claude-config/               # Claude Code config (symlinked into ~/.claude/)
├── scripts/
│   ├── build.sh                 # Regenerate marketplace catalogs
│   └── validate.sh              # Lint manifests, skills, references
└── .github/workflows/
    └── build.yml                # CI

---

Contributing

See AGENTS.md for the full contributor guide — plugin/skill conventions, manifest formats, and the step-by-step workflow for adding new plugins.

./scripts/build.sh        # regenerate marketplace catalogs
./scripts/validate.sh     # lint everything

Bumping a plugin version

1. Edit version in both manifest files (must match — validate.sh will fail if they differ):
   • plugins/<name>/.claude-plugin/plugin.json
   • plugins/<name>/.cursor-plugin/plugin.json
2. Rebuild and validate:

   ./scripts/build.sh <name>
   ./scripts/validate.sh <name>
   

3. Commit everything — marketplace catalogs are updated by build.sh and must be committed alongside the manifests:

   git add plugins/<name>/.claude-plugin/plugin.json \
           plugins/<name>/.cursor-plugin/plugin.json \
           .claude-plugin/marketplace.json \
           .cursor-plugin/marketplace.json
   git commit -m "chore(k8s): bump version to x.y.z"
   

CI will rebuild and re-commit the catalogs automatically on push to main, so step 2 is optional if you push directly.