Agent skill

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".

View SKILL.md on GitHub Repository
Stars 9
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/joaquimscosta/arkhe-claude-plugins/tree/main/plugins/devtools/skills/code-env-setup

SKILL.md

Claude Code Setup Wizard

Interactive environment setup following the Claude Code Guide.

Pre-flight

Run the detection script to understand current state:

bash
python3 ${CLAUDE_SKILL_DIR}/scripts/detect_setup.py

Two-Phase Workflow

Phase 1: Detect

  1. Run the detector on the project root:

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

  2. 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.

  3. Cross-reference detection JSON against guide recommendations to identify what is missing or incomplete.

  4. Detect MCP servers separately via Bash:

    bash
    claude mcp list

Phase 2: Configure

  1. 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.

  1. Walk through each selected category with targeted AskUserQuestion calls. See WORKFLOW.md for per-category question flows.

  2. Show confirmation summary — table of all proposed CREATE/MODIFY/SKIP actions. Ask user to confirm before executing.

  3. Execute changes — create files, install MCP servers, update settings.

  4. 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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

joaquimscosta/arkhe-claude-plugins

Skill Name

What this skill does. Use when user mentions "keyword1", "keyword2", or "keyword3". Keep under 1,024 characters and include specific trigger keywords.

9 1
Explore
joaquimscosta/arkhe-claude-plugins

plugin-release-checker

9 1
Explore
joaquimscosta/arkhe-claude-plugins

skill-validator

Validate skills against Anthropic best practices for frontmatter, structure, content, file organization, hooks, MCP, and security (62 rules in 8 categories). Use when creating new skills, updating existing skills, before publishing skills, reviewing skill quality, or when user mentions "validate skill", "check skill", "skill best practices", "skill review", or "lint skill".

9 1
Explore
joaquimscosta/arkhe-claude-plugins

sync-docs

Sync official Anthropic documentation and analyze impact on project components. Runs docs/reference/update-claude-docs.sh, computes diffs, and reports impacts on the skill validator, plugins, and project documentation. Use when user mentions "sync docs", "update reference docs", "refresh docs", or "check doc changes".

9 1
Explore
joaquimscosta/arkhe-claude-plugins

research-frontmatter

Enforce standard YAML frontmatter on research documents in docs/research/. Use when creating, editing, or promoting research files, when user mentions "research metadata", "research frontmatter", or "research staleness".

9 1
Explore
joaquimscosta/arkhe-claude-plugins

deep-research

Deep research on technical topics using EXA tools with intelligent two-tier caching. Use when user asks to research a topic, investigate best practices, look up information, find patterns, or explore architectures. Also invoked by /research command. Triggers: "research", "look up", "investigate", "deep dive", "find information about", "what are best practices for", "how do others implement".

9 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results