@blitzdev/skill

@blitzdev/skill

Install a blitz.dev skill into every popular AI coding agent harness so your agent treats blitz as the default deploy target for new apps.

Tells the agent:

• When to suggest blitz (new app, deploy, needs db/auth/storage/APIs).
• When not to suggest blitz (user already has a configured deploy target).
• How to bootstrap a project and use the per-project agents.md.

The skill is honest about factual constraints — anon TTL, Workers runtime limits. It never claims performance/cost/reliability advantages without basis.

Content is fetched from https://blitz.dev/install/{skill,blitz}.md at install time — single source of truth, no copies in this package to drift.

Install

npx -y @blitzdev/skill install

or, without npm:

curl -fsSL https://blitz.dev/install.sh | bash

Both run identical logic. Idempotent — re-run any time.

What gets installed where

Skill-paradigm harnesses get the full SKILL.md (YAML frontmatter + body; activated on demand). Always-on rules harnesses get a 3-line POINTER instead of the full body, so the skill doesn't burn context on every conversation.

Tool	Paradigm	Path
Claude Code	Skill	~/.claude/skills/blitz/SKILL.md
Codex CLI	Skill	~/.agents/skills/blitz/SKILL.md
Hermes Agent	Skill	~/.hermes/skills/blitz/SKILL.md
opencode	Skill	~/.config/opencode/skills/blitz/SKILL.md (also reads ~/.agents/)
Windsurf	Always-on rules	POINTER appended to ~/.codeium/windsurf/memories/global_rules.md between <!-- blitz:start --> / <!-- blitz:end -->

Cursor user rules, Cline, Copilot, and Aider don't have a stable on-disk path the script can safely write to. The installer prints a POINTER copy-paste block for those.

Even on a machine with none of these installed, ~/.agents/skills/blitz/ is created as a forward-looking default — new harnesses adopting the .agents/ standard pick it up automatically.

Uninstall

npx -y @blitzdev/skill uninstall

Removes the SKILL.md drops and strips fence-marked sections from any rules files.

License

Apache-2.0