agent-starter-kit git:20260921.d75690aA

Immutable. This exact content is served forever at /api/v1/blob/4b10be055134c944.

---
name: agent-starter-kit
description: One-command setup for a new AI coding agent. Installs the essential starter skills (find-skills, agent-browser, karpathy-guidelines, ui-ux-pro-max, caveman, arabic-design, design-taste-frontend, remotion-best-practices) across 70+ agents, plus the core Claude Code plugins/MCPs (frontend-design, superpowers, code-review, playwright, github, claude-md-management). Use when the user is setting up a new project or a fresh agent and asks for "the skills/MCPs I should start with", a "starter pack", or "set up my agent".
---

# Agent Starter Kit

The skills, plugins, and MCP servers worth installing the moment you open a new
agent — bundled into one install. Instead of hunting them down one by one, run the
installer and the agent starts with real capabilities: it can find and install more
skills on demand, drive a browser, reason with guardrails, design clean UI (Arabic
included), review its own code, and automate the browser + GitHub.

## What it installs

**Tier 1 — Skills (work on 70+ agents via `npx skills`: Claude Code, Codex, Cursor, …):**
| Skill | What it gives the agent |
|---|---|
| `find-skills` | Discovers and installs any other skill on demand — the meta-skill |
| `agent-browser` | A real browser the agent controls itself (open, click, fill, verify) |
| `karpathy-guidelines` | Behavior rules: no silent assumptions, minimal solutions, verify before acting |
| `ui-ux-pro-max` | Design-system intelligence — styles, color palettes, font pairings |
| `caveman` | Blunt, no-fluff answers when you want signal over politeness |
| `arabic-design` | Clean Arabic in AI-generated designs (fixes the letter-spacing/RTL traps) |
| `design-taste-frontend` | Design taste for landing pages, portfolios and redesigns — stops templated, generic UI ([tasteskill](https://github.com/Leonxlnx/taste-skill)) |
| `remotion-best-practices` | Video in React with Remotion — the **official** skill, a router carrying 11 nested references (create · markup · captions · render · studio · maps · …) |

**Tier 2 — Plugins / MCPs (Claude Code only):**
| Plugin / MCP | What it gives Claude Code |
|---|---|
| `frontend-design` | Anthropic's design guidance for polished, non-generic UI |
| `superpowers` | TDD + subagent orchestration workflow (brainstorm → design → build → review) |
| `code-review` | `/code-review` on any branch/PR — scored, actionable review |
| `playwright` (MCP) | Browser automation & end-to-end testing |
| `github` (MCP) | Read/manage GitHub repos, PRs, and issues from the agent |
| `claude-md-management` | Keeps your `CLAUDE.md` files organized and current |

## How to run it

From the skill directory:

```bash
bash install.sh                 # Claude Code — installs everything
bash install.sh --agent cursor  # Cursor — installs the Tier 1 skills
bash install.sh --agent codex   # Codex  — installs the Tier 1 skills
bash install.sh --agent '*'     # every detected agent
bash install.sh --skills-only   # skip the Claude-Code-only plugins/MCPs
```

The script is **best-effort and safe to re-run**: each item installs independently, and
anything it can't install automatically prints the exact manual command to finish it.

## When invoked as a skill

If an agent loads this skill to set up an environment: run `install.sh` with the right
`--agent` for the current agent. Then confirm what installed and surface any manual
fallback lines the script printed. In Claude Code, remind the user to restart (or run
`/plugin`) so the new plugins load.

## Honest scope note

- **Tier 1 skills are genuinely cross-agent** — `npx skills` targets 70+ agents.
- **`design-taste-frontend` is scoped by its own authors** to landing pages, portfolios
  and redesigns — *not* dashboards, data tables, or multi-step product UI. It is also large
  (~87KB), so it costs real context when it fires. If a project's UI is a dashboard, or it
  already has a locked visual system, leave it out of the loop rather than letting it argue
  with the system you already decided on.
- **`remotion-best-practices` is one entry, not twelve.** The official repo ships 12 skills,
  but the router installs with all 11 others nested inside it and every relative link
  resolving (verified). Installing the single router keeps the agent's skill list clean and
  loses nothing — do not "fix" this by adding the siblings as separate entries.
- **Tier 2 is Claude Code only.** Codex/Cursor have no "plugin" equivalent. Their two
  *MCP* items (`playwright`, `github`) can still be added to Codex/Cursor through that
  agent's own MCP config — the script says so when you pass a non-Claude `--agent`.