@blitzdev/skill
v0.0.3
Published
Install a blitz.dev skill into Claude Code, Codex, opencode, Hermes, and other agent harnesses.
Maintainers
Readme
@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 installor, without npm:
curl -fsSL https://blitz.dev/install.sh | bashBoth 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 uninstallRemoves the SKILL.md drops and strips fence-marked sections from any rules files.
License
Apache-2.0
