메뉴
Use when initializing a new project with devenv, direnv, and jj version control. Triggers on: setting up dev environment, configuring nix shell, project bootstrap.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | devenv-init |
| description | Use when initializing a new project with devenv, direnv, and jj version control. Triggers on: setting up dev environment, configuring nix shell, project bootstrap. |
Bootstrap a development environment with jj (git-backed), devenv (nix-based tools), and direnv (auto-activation). Idempotent - safe to run multiple times to update configuration.
bash .claude/skills/devenv-init/setup-devenv.sh # Full setup
bash .claude/skills/devenv-init/setup-devenv.sh --force # Regenerate devenv.nix
bash .claude/skills/devenv-init/setup-devenv.sh --analyze # Analyze only
| Detected | Source | Generated Config |
|---|---|---|
| Rust | Cargo.toml | languages.rust, cargo-watch, rustfmt/clippy hooks |
| Python | pyproject.toml | languages.python, ruff, uv, pytest |
| Node | package.json | languages.javascript, pnpm/yarn, scripts from package.json |
| Go | go.mod | languages.go, golangci-lint, gofmt hook |
| Tools | Makefile, justfile | packages (gnumake, just) |
| File | Behavior on Re-run |
|---|---|
| .envrc | Updates if managed, backs up if not |
| devenv.nix | Skips unless --force, backs up if unmanaged |
| devenv.yaml | Skips if exists |
| .jj | Initializes only if missing |
Files managed by this skill contain a marker comment. Unmanaged files are backed up before overwriting.
--force, -f Regenerate devenv.nix even if already managed
--analyze, -a Only analyze repo, show recommendations, don't write
--help, -h Show help
| Section | Auto-populated From |
|---|---|
| packages | Detected tools (cargo-watch, ruff, pnpm, etc) |
| scripts | Common dev commands (check, lint, test, dev) |
| tasks | Build/test commands for devenv tasks run |
| processes | Dev servers from package.json scripts |
| pre-commit.hooks | Language-appropriate formatters/linters |
The generated .envrc gracefully handles:
use_nixUse devenv-query.sh to explore available options without loading full docs:
# List all available languages
bash .claude/skills/devenv-init/devenv-query.sh langs
# List all available services
bash .claude/skills/devenv-init/devenv-query.sh services
# Search options for a specific feature
bash .claude/skills/devenv-init/devenv-query.sh options languages.rust
bash .claude/skills/devenv-init/devenv-query.sh options services.postgres
# Search nixpkgs for packages
bash .claude/skills/devenv-init/devenv-query.sh packages ripgrep
# Evaluate current devenv.nix config (returns JSON)
bash .claude/skills/devenv-init/devenv-query.sh eval languages.rust.enable
Results are cached for 24h in ~/.cache/devenv-init/.
| Issue | Fix |
|---|---|
| "No git or jj repository" | Run git init first |
| "Not git-backed" | Run jj git init --colocate |
| Want to regenerate | Run with --force |
| Wrong detection | Edit devenv.nix manually, it won't be overwritten |
| Need option details | Run devenv-query.sh options <path> |
Research and recommend the best local LLM model stack for the current machine. Detects hardware (CPU, GPU, RAM, VRAM), discovers installed hosting stacks (Ollama, llama.cpp, vLLM, etc.), searches Hugging Face for compatible models, and enables easy downloads. Use when the user wants to find, evaluate, or download local AI models that will run well on their system.
Zellij terminal multiplexer — creating KDL layouts, managing sessions via CLI, and running commands without disrupting the user's workspace
Use when adding a new service to a Nix flake — creating packages from upstream repos (Go, Node, Python), writing service modules, managing configs, wiring secrets, and testing. Covers the full lifecycle from source to running daemon.
Use when a launchd service on nix-darwin fails to start, exits with non-zero status, or doesn't restart after a switch. Triggers on: exit code 78, "EX_CONFIG", "Operation not permitted", daemon vs user.agent decisions, plist not being reloaded.
Use when managing 1Password secrets via Nix on nix-darwin. Triggers on: adding API keys, tokens, or credentials to service configs; wiring opnix 1Password items into home-manager modules; creating opnix-managed secret files with activation script ordering.
Use when tracking, planning, implementing, or reviewing work using yx (yaks) with the autonomous /shave loop, or when multiple agents need to coordinate on shared tasks