菜单
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 职业分类
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
| 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> |