Uh oh!
There was an error while loading. Please reload this page.
Add use-devbox agent skill - #2837
Merged
Merged
Conversation
Add a Claude Code skill that teaches agents how to detect and use a devbox environment: checking for installation, finding devbox.json, running commands and project scripts via devbox run, sourcing binaries, services, and global packages.
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a Claude Code agent skill at .claude/skills/use-devbox/SKILL.md documenting how AI agents should detect and use devbox environments in a repo.
Changes:
- New skill file with detection, install, run, and binary-source-ordering guidance
- Documents
devbox runpreference overdevbox shellfor non-interactive use - Notes project scripts, services, and global package commands
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Lagoja
approved these changes
Jun 1, 2026
Lagoja
left a comment
Contributor
There was a problem hiding this comment.
This looks great, thanks for adding!
Uh oh!
There was an error while loading. Please reload this page.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a Claude Code agent skill at
.claude/skills/use-devbox/SKILL.mdthat teaches AI coding agents how to detect and use a devbox environment.Why
Agents working in a repo that uses devbox often don't realize that project tools (psql, python, gcloud, node, etc.) live inside the devbox environment rather than on the bare shell. As a result they conclude a tool is "unavailable" when devbox actually provides it. This skill gives an agent a clear, ordered playbook so it reaches for devbox at the right time.
What the skill covers
devbox.jsonexists, a tool seems missing, or the user mentions devbox.command -v devbox, with the official non-interactive installer.devbox.jsonin the cwd, an ancestor, or a subdir root.devbox run [cmd]for one-off, non-interactive use overdevbox shell.devbox run test,lint,build, …) defined indevbox.json.devbox search/devbox add(only with the user's confirmation before mutatingdevbox.json).Install URL and example scripts in the skill match this repo's
README.md/devbox.md/devbox.json.https://claude.ai/code/session_01K1cHquYtVhkYErHrKgNUHW
Generated by Claude Code