AgentSkillsCN

setup-claude-dev-kit

当为Claude Code设置新开发机、项目入职或优化开发环境时使用——交互式安装程序，检测现有设置，配置shell、编辑器、git、模板以及可配置强制的质量门。

SKILL.md
--- frontmatter
name: setup-claude-dev-kit
description: Use when setting up a new dev machine for Claude Code, onboarding to a project, or optimizing development environment - interactive installer that detects existing setup, configures shell, editor, git, templates, and quality gates with configurable enforcement

Setup Claude Dev Kit

Overview

Claude-native installer for a comprehensive developer environment. Detects existing setup and adapts accordingly - greenfield gets opinionated defaults, existing setups get respectful merges.

When to Use

  • •Setting up new dev machine for Claude Code
  • •Onboarding to a team using Claude
  • •Optimizing existing development environment
  • •User asks about Claude dev setup, environment, or tooling

Quick Reference

BundleComponents
minimalshell
standardshell, editor, git, templates
fullshell, editor, git, templates, quality, memory

Installation Flow

0. Quick Start Question (First Prompt)

Ask immediately before anything else:

code
Welcome to Claude Dev Kit!

How would you like to proceed?

1. 🍀 Feeling Lucky - Auto-configure everything with smart defaults
2. 🎛️  Guided Setup - Walk me through the options

If "Feeling Lucky" selected:

  • •Skip all subsequent prompts
  • •Auto-detect environment (greenfield vs adaptation)
  • •Install standard bundle (shell, editor, git, templates)
  • •Use these defaults:
    • •Shell: Install p10k, keep existing aliases
    • •Editor: Add extensions, merge settings (don't overwrite)
    • •Git: Add hooks and templates, preserve existing config
    • •Templates: Create CLAUDE.md if missing
    • •Quality enforcement: soft (warns but allows bypass)
  • •Backup everything before changes
  • •Show summary at end

Feeling Lucky behavior:

code
🍀 Feeling Lucky mode activated!

Detecting environment... macOS, zsh, VS Code
Mode: Greenfield

Installing standard bundle:
  → Shell (zsh, powerlevel10k, fonts, aliases)
  → Editor (VS Code settings, extensions)
  → Git (hooks, templates, conventions)
  → Templates (CLAUDE.md, .claude/ directory)

Creating backups... done
Installing components... [progress]

✓ Complete! Restart your terminal to activate.

1. Detect Environment

bash
# Check OS
uname -s  # Darwin, Linux, etc.

# Check shell
echo $SHELL
[ -d ~/.oh-my-zsh ] && echo "Oh My Zsh installed"

# Check editor
command -v code && echo "VS Code installed"
command -v cursor && echo "Cursor installed"

# Check existing customization (adaptation signals)
[ -f ~/.p10k.zsh ] && echo "Powerlevel10k configured"
[ -f ~/.gitconfig ] && echo "Git configured"
ls ~/.vscode/extensions 2>/dev/null | wc -l

2. Determine Mode

Greenfield signals:

  • •Default shell prompt (no p10k/starship/oh-my-zsh)
  • •No ~/.gitconfig or minimal config
  • •VS Code with <5 extensions
  • •No ~/.claude directory

Adaptation signals:

  • •Custom shell theme/prompt
  • •Extensive git aliases
  • •Editor heavily customized
  • •Existing dotfiles repo

3. Present Options

code
Detected: macOS 14.x, zsh, VS Code, [Greenfield/Adaptation] mode

Which bundle would you like?
1. Minimal - shell only (~2 min)
2. Standard - shell + editor + git + templates
3. Full - everything including quality gates
4. Custom - pick individual components

4. Install Components

For each selected component, invoke its skill:

  • •setup-cdk-shell - Shell environment
  • •setup-cdk-editor - Editor configuration
  • •setup-cdk-git - Git workflow
  • •setup-cdk-templates - Project templates
  • •setup-cdk-quality - Quality gates
  • •setup-cdk-memory - Context management

5. Adaptation Mode Behaviors

When existing setup detected:

  1. •Backup first:
bash
mkdir -p ~/.claude-dev-kit/backups/$(date +%Y-%m-%d)
cp ~/.zshrc ~/.claude-dev-kit/backups/$(date +%Y-%m-%d)/
  1. •

    Show diff before changes - Get user approval

  2. •

    Merge, don't replace:

bash
# Append to .zshrc rather than overwrite
echo "# Claude Dev Kit additions" >> ~/.zshrc
  1. •Conflict resolution:
code
You have starship installed. We recommend powerlevel10k.
1. Keep starship (skip shell theme)
2. Try powerlevel10k (backs up starship config)
3. Skip shell setup entirely

6. Quality Gate Configuration

code
What enforcement level for quality checks?
1. Advisory - suggestions only, never blocks
2. Soft - warns but allows --no-verify bypass
3. Hard - must pass, CI enforced

7. Verify & Report

bash
# Verify installations
command -v p10k && echo "✓ Powerlevel10k"
[ -f ~/.claude/settings.json ] && echo "✓ Claude configured"
[ -d .git/hooks ] && echo "✓ Git hooks"

Generate adoption score:

code
Environment Score: 8/10 Claude-optimized

Installed:
✓ Shell completions
✓ Powerlevel10k theme
✓ Git hooks
✓ CLAUDE.md template

Optional additions:
- Quality gates (+1)
- Memory tools (+1)

Key Behaviors

  • •Idempotent - Safe to re-run, updates rather than duplicates
  • •Rollback-aware - Tracks changes, can undo if something fails
  • •Progress visible - Uses TodoWrite so user sees status
  • •Non-destructive - Backs up existing configs before modifying

Component Skills

SkillPurpose
setup-cdk-shellZsh, p10k, fonts, completions, aliases
setup-cdk-editorVS Code/Cursor settings, extensions
setup-cdk-gitHooks, commit templates, PR templates
setup-cdk-templatesCLAUDE.md templates, project scaffolds
setup-cdk-qualityLinting, testing, review automation
setup-cdk-memoryContext/conversation management

Updating

bash
# Check for updates
Skill: update-claude-dev-kit

# Update specific component
Skill: update-cdk-shell