Reference and setup guide. Everything you need to install, update, and understand what the pack adds to your agent — plus the curation decisions behind it.
The simplest path is to paste a single prompt into your agent:
Set up Floom Starter Pack: https://floom.dev/starter
Your agent reads the manifest at that URL and installs the right files for its runtime. No account needed. Nothing to configure.
If you prefer to run it yourself:
npx @floomhq/starter
The CLI detects which agent config files exist on your machine and writes only to the appropriate paths.
The pack writes three things per supported agent:
| File | Purpose |
|---|---|
| AGENTS.md / CLAUDE.md | Activation rules — tell the agent when to invoke each skill, using the AGENTS.md pattern Vercel found achieves 100% invocation rate. |
| .floom/skills.json | Skill manifest — the full list of installed skills, their sources, install counts, and profile tags. Used by the find-skills meta-skill for discovery without loading all 97 into context. |
| .floom/starter.lock | Lock file — records the pack version and install date. Used by npx @floomhq/starter update to pull only changed skills. |
Total size on disk: approximately 120 KB for the full 97-skill pack. Individual skill files average 1.2 KB.
The pack supports five agents out of the box. Each agent reads skill context from a different path.
| Agent | Activation file | Skills path |
|---|---|---|
| Claude Code | ~/.claude/CLAUDE.md |
~/.claude/skills/ |
| Codex CLI | ~/.codex/AGENTS.md |
~/.codex/skills/ |
| Cursor | .cursorrules (project root) |
.cursor/skills/ |
| OpenCode | AGENTS.md (project root) |
.opencode/skills/ |
| Kimi | AGENTS.md (project root) |
.kimi/skills/ |
When you run the installer, it detects which of these directories exist and writes only to the ones that do. If none are found, it prompts you to choose.
The skill manifest is updated daily as new skills are published to skills.sh. To pull the latest version:
npx @floomhq/starter update
This reads your existing .floom/starter.lock, fetches the latest manifest, and writes only the files that have changed. Your existing activation rules in AGENTS.md or CLAUDE.md are preserved.
To update via your agent, paste:
Update Floom Starter Pack to latest: https://floom.dev/starter/update
To remove all files the pack added:
npx @floomhq/starter remove --all
This deletes the .floom/ directory and removes the Floom activation block from your AGENTS.md or CLAUDE.md. It does not touch anything outside the paths the installer originally wrote to.
To remove only a specific agent's config:
npx @floomhq/starter remove --agent claude-code
The Floom Starter Pack is a local install. After the initial download, it operates entirely on your machine.
The Floom Starter Pack installer and tooling is MIT licensed. This means you can use, modify, and redistribute it freely.
Individual skills in the pack carry their own licenses. The breakdown:
| License | Skills | Count |
|---|---|---|
| MIT | All superpowers, mattpocock, vercel-labs, coreyhaines31, scrapegraphai, wshobson, currents-dev, remotion-dev skills | 62 skills |
| Apache 2.0 | All benchflow-ai/skillsbench, pbakaus/impeccable, supabase/agent-skills, and most anthropics/skills | 29 skills |
| Source-available | docx, pdf, pptx, xlsx from anthropics/skills (use freely, not fully OSS) | 3 skills |
| Proprietary | workplan, wireframe-to-react, video-polish (Floom team, full rights granted for pack distribution) | 3 skills |
Each skill file includes a license header. If you redistribute individual skills, preserve the header.
The full technical shape of the pack: how the installer resolves targets, what files get written, how agents discover installed skills, and what V0 guarantees.
The package contains a manifest plus bundled skill folders. The installer resolves selected profiles, detects local agents, writes skills into their native roots, writes a local index, and adds instructions that teach agents to search locally.
When the user runs install, explicit targets win. If no target is passed, the CLI detects local agent config directories and installs only to those agents.
npx @floomhq/packs install --profiles core,dev,writing --yes
Each target receives skill folders in its native root, a harness instruction file, and a shared local index at ~/.floom/packs/starter-index.json.
Every installed skill gets a provenance file. Managed pack skills can be replaced by later installs; untracked user-created folders are protected by default.
No MCP is required in V0. The discovery loop is local: injected instructions point the agent at the starter index and the local-find-skills skill.
The manifest links profiles to skills, and skills to their upstream source records — keeping provenance legible and auditable.
Next curation pass planned sources:
| Source | Goal | Gate |
|---|---|---|
| skills.sh | Broad public skill ecosystem | License and attribution verification |
| Native Claude skills | High-quality agent-native patterns | Redistribution rights and adaptation policy |
| gstack | Strong developer workflow ideas | Standalone extraction without telemetry/update coupling |
| superpowers | Potential broad workflow skills | License/provenance review |
| Other open sources | Fill profile gaps | Clear source URL, commit, license, and quality score |
Behaviors confirmed across all five launch targets. These are the acceptance criteria for any release.
--targets all writes all five launch targets.Skills.sh indexes 91,035 skills. We curated 63 of them. The selection rules:
The 4 source tiers, in priority order:
| Source | Skills in pack | Why this tier |
|---|---|---|
| skills.sh | 84 skills (87%) | Battle-tested, real install counts, diverse publishers |
| Superpowers (obra, MIT) | 14 (sub-source of skills.sh) | Highest install counts in workflow/planning category |
| SkillsBench (Apache 2.0) | 10 skills | Academic validation on real benchmarks |
| Floom proprietary | 3 skills | Last resort only: workplan, wireframe-to-react, video-polish fill gaps with no proven equivalent |
Vercel published research showing that agents skip 56% of installed skills by default. Even with an explicit "use these skills" prompt, invocation only reaches 70%. The AGENTS.md activation pattern achieves 100%.
The pattern works by embedding per-skill trigger conditions directly into the agent's context file (CLAUDE.md or AGENTS.md). Instead of telling the agent "you have 63 skills available," it tells the agent: "when the user says X, invoke Y."
systematic-debugging."Source for the 100% claim: Vercel's agent evals post. The AGENTS.md pattern is also the basis for Anthropic's own Claude Code setup.
The SkillsBench paper (arxiv.org/abs/2602.12670) tested agent performance across three skill installation strategies:
The mechanism: irrelevant skills confuse the agent about what to use. A kitchen-sink install forces the agent to evaluate 200+ options per task, increasing both latency and error rate. The sweet spot is 2-3 well-matched skills per task, which is exactly what profile-based curation produces.
This is why the pack uses profile tags. When you label yourself as a developer, you get the 12 dev skills in your activation block, not all 97. The agent doesn't know about skills outside your selected profiles unless it invokes find-skills specifically.
Floom doesn't author most of the skills in this pack. We curate them from the open ecosystem (mostly skills.sh) and add five things on top:
When you install via Floom, you're getting the original author's skill — with the activation, distribution, and update layer Floom provides on top. We link every skill to its source repo. Floom doesn't intermediate the code.
Skills run inside your agent, on your API key, using your token budget. Floom is the distribution layer. We curate, package, and activate. Your agent executes.
This is intentional. Skills that run on a third-party runtime can't access your local filesystem, your git repo, or your project context. Skills that run in your agent can do all three. The power of skills is that they run where your agent runs.
Floom's business is the distribution infrastructure: the manifest, the installer, the activation pattern, and the curation. Not the inference.