@floomhq/starter

@floomhq/starter

Install curated AI agent skills for Claude Code, Codex, Cursor, OpenCode, and Kimi — zero dependencies, one command.

npx @floomhq/starter install --profiles core,dev

What it does

• Detects your installed AI agents (Claude Code, Codex, Cursor, OpenCode, Kimi)
• Installs skill files to each agent's local skill directory
• Appends an activation companion block to your agent's instruction file (CLAUDE.md, AGENTS.md, etc.)
• Writes a local manifest at ~/.floom/manifest.json

Commands

# Install by profile
npx @floomhq/starter install --profiles core
npx @floomhq/starter install --profiles core,dev,writing

# Install specific skills
npx @floomhq/starter install --skills pr-review,task-brief

# Install everything
npx @floomhq/starter install --all

# Interactive setup (asks your role, picks profiles)
npx @floomhq/starter init

# Show installed skills
npx @floomhq/starter list

# Remove all installed skills
npx @floomhq/starter remove --all

Flags

Flag	Description
--profiles <ids>	Comma-separated profile IDs
--skills <slugs>	Comma-separated skill slugs
--all	Install all available skills
--harness <ids>	Target specific agents: claude,codex,cursor,opencode,kimi
--force	Overwrite existing skills
--dry-run	Print plan without installing

Profiles

ID	Description
core	Skill discovery, task framing, project onboarding
dev	Code review, tests, security, browser, repo analytics
writing	Brand voice, email drafts, presentations
research	Research briefs, citations, enterprise search
marketing	Landing pages, positioning, customer synthesis
sales	Outbound, customer context, sales analysis
ops	Meetings, SOPs, onboarding, file organization
founder	Strategy, research, customer learning, decisions
data	Spreadsheets, PDFs, financial QA
design	Visual QA, browser implementation checks
video	Transcript, silence, filler-word workflows

Skills installed per agent

Agent	Skill directory	Activation file
Claude Code	~/.claude/skills/<slug>/SKILL.md	~/.claude/CLAUDE.md
Codex CLI	~/.codex/skills/<slug>/SKILL.md	~/.codex/AGENTS.md
Cursor	~/.cursor/rules/<slug>.mdc	~/.cursor/rules/floom-skills.mdc
OpenCode	~/.config/opencode/skills/<slug>/SKILL.md	~/.config/opencode/AGENTS.md
Kimi	~/.kimi/skills/<slug>/SKILL.md	~/.kimi/agents/floom-system.md

Updating

There is no auto-update. To pull the latest manifest and skills, re-run the install command with the @latest tag:

npx @floomhq/starter@latest install --profiles core,dev

@latest fetches the newest package version from npm. Re-running install refetches the public manifest. The operation is idempotent: skills you have already customised are skipped (the collision check in CLI 0.2.1 preserves your versions).

Uninstalling

# Remove everything
npx @floomhq/starter remove --all

# Remove specific skills
npx @floomhq/starter remove --skills pr-review,brand-voice

# Remove an entire profile
npx @floomhq/starter remove --profiles dev

remove deletes the SKILL.md files the installer wrote, clears the Floom activation block from CLAUDE.md / AGENTS.md, and deletes ~/.floom/manifest.json. Files the collision check skipped (your custom versions) are not touched.

Listing what's installed

npx @floomhq/starter@latest list

Lists every skill installed via Floom, which profile it belongs to, and which agent paths it was written to.

After install

Ask your agent: "review the changes in this branch" — the pr-review skill fires automatically.

Or: "find a skill for this task" — local-find-skills searches your installed skills.

Zero dependencies

@floomhq/starter uses only Node.js built-ins (Node 18+). No install overhead.

Part of Floom

floom.dev — the skill registry for AI coding agents.