Skip to content

Add agent skill for devbox#2823

Open
mikeland73 wants to merge 1 commit intomainfrom
mikeland73/devbox-skill
Open

Add agent skill for devbox#2823
mikeland73 wants to merge 1 commit intomainfrom
mikeland73/devbox-skill

Conversation

@mikeland73
Copy link
Copy Markdown
Collaborator

Summary

  • Adds a devbox agent skill under skills/devbox/ following the Vercel / skills.sh format (SKILL.md with YAML frontmatter + references/ directory).
  • SKILL.md covers the quick start, devbox.json overview, a decision tree routing to references, lockfile hygiene, host-shell integration (direnv / shellenv), CI guidance, and anti-patterns.
  • References split by topic: devbox-json.md (full schema), packages.md (add/rm/update/search/platforms/runx), scripts-services.md (devbox run, services, init_hook pitfalls), global-and-templates.md (global, create, generate, secrets, auth).
  • Activation metadata includes pathPatterns (devbox.json, devbox.lock, .devbox/**) and bashPatterns (^\s*devbox) so compatible agents can auto-load the skill.

Test plan

  • Skim skills/devbox/SKILL.md for accuracy against current CLI behavior.
  • Verify references cover the common workflows (add / shell / run / services / global / generate).
  • Try installing with npx skills add jetify-com/devbox (once merged) and confirm Claude Code / Cursor pick up the skill.

🤖 Generated with Claude Code

Packages devbox usage guidance as a SKILL.md so AI coding agents
(Claude Code, Cursor, Copilot, etc.) have structured, production-ready
reference material for authoring devbox.json, managing Nix packages,
writing scripts/services, and generating Dockerfiles or devcontainers.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
@mikeland73 mikeland73 requested review from Lagoja and savil April 22, 2026 19:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant