Code env setup

Skill joaquimscosta/arkhe-claude-plugins/plugins/devtools/skills/code-env-setup

Interactive Claude Code environment setup wizard. Detects existing configuration, guides through best-practice setup for Global CLAUDE.md, project scaffolding, MCP servers, hooks, custom agents, keybindings, and settings. Use when user runs /devtools:code-env-setup, mentions "setup claude code", "configure claude", "claude code setup", "environment setup", or "initialize claude code".From its SKILL.md

Install

npx -y skills add joaquimscosta/arkhe-claude-plugins --skill code-env-setup

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

3 things to look at

21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 3 commands, including `python3 ${CLAUDE_SKILL_DIR}/scripts/detect_setup.py` and 2 more.
fetches URLsInstructs the agent to fetch 1 URL, including https://raw.githubusercontent.com/joaquimscosta/arkhe-claude-plugins/main/docs/CLAUDE_CODE_GUIDE.md.

SKILL.md

3.8 KB, 842 tokens by cl100k_base, as published. Nobody here has run it

Claude Code Setup Wizard

Interactive environment setup following the Claude Code Guide.

Pre-flight

Run the detection script to understand current state:

python3 ${CLAUDE_SKILL_DIR}/scripts/detect_setup.py

Two-Phase Workflow

Phase 1: Detect

Run the detector on the project root:

python3 ${CLAUDE_SKILL_DIR}/scripts/detect_setup.py <project-root>

Fetch the guide via WebFetch:
```
https://raw.githubusercontent.com/joaquimscosta/arkhe-claude-plugins/main/docs/CLAUDE_CODE_GUIDE.md
```
If WebFetch fails (network error, 404), warn the user and proceed using LLM knowledge only.
Cross-reference detection JSON against guide recommendations to identify what is missing or incomplete.
Detect MCP servers separately via Bash:
```
claude mcp list
```

Phase 2: Configure

Present category selection using AskUserQuestion (multiSelect: true). Show detection status for each category (configured / partially configured / not configured):

#	Category	Guide Section	What It Configures
1	Global CLAUDE.md	Section 1	`~/.claude/CLAUDE.md` — security NEVER rules, account config
2	Project Scaffolding	Section 2	`.claude/` dirs, `.env.example`, `.gitignore`, `CLAUDE.md`
3	MCP Servers	Section 3	Install recommended servers via `claude mcp add`
4	Hooks	Section 7	`~/.claude/hooks/block-secrets.py`, hooks in settings.json
5	Custom Agents	Section 10	`~/.claude/agents/` starter agent files
6	Keybindings	Section 13	`~/.claude/keybindings.json`
7	Settings	Section 13	Language, background tasks in settings.json

If user passed a specific category as argument (e.g., /devtools:code-env-setup hooks), skip the selection and go directly to that category.

Walk through each selected category with targeted AskUserQuestion calls. See WORKFLOW.md for per-category question flows.
Show confirmation summary — table of all proposed CREATE/MODIFY/SKIP actions. Ask user to confirm before executing.
Execute changes — create files, install MCP servers, update settings.
Post-setup summary — show what was configured, next steps, and remind user they can re-run /devtools:code-env-setup for incremental updates.

Key Rules

Never overwrite existing files without asking. Always offer merge/replace/skip.
Detect first — skip items already configured.
Use AskUserQuestion for every decision. Do not assume user preferences.
Merge settings — when updating settings.json, read existing content first and deep-merge.
MCP servers — ask scope (global -s user vs project -s project) before installing.

Guide Reference

Fetch at runtime — do not cache or embed:

Claude Code Guide: https://raw.githubusercontent.com/joaquimscosta/arkhe-claude-plugins/main/docs/CLAUDE_CODE_GUIDE.md

References

Workflow: See WORKFLOW.md for per-category setup flows
Examples: See EXAMPLES.md for example setup sessions
Troubleshooting: See TROUBLESHOOTING.md for common issues
Detection Script: See scripts/detect_setup.py for detection logic

What ships with it: 4 files

19.7 KB alongside SKILL.md, 1 of them executable

scripts/

detect_setup.pyruns4.0 KB