Claude Code Mastery

Complete skill for setting up, optimizing, and mastering Claude Code with a full development team of subagents.

Official Docs: https://code.claude.com/docs

⚡ Quick Check: Is Setup Complete?

Run this first:
CODEBLOCK0

If Claude Code is already installed, skip directly to the "Daily Use" section below.

🔧 FIRST-TIME SETUP (Skip if already installed)

Note to bot: Only follow this section if Claude Code is NOT installed. Check with the command above. Once setup is complete, this section can be ignored on future invocations.

Setup Scripts

Run these in order:

CODEBLOCK1

Configuration

Edit config.sh to customize:

• - VALID_MODELS — Add models as Anthropic releases them
• INLINECODE2 — Enable/disable in heartbeat (default: false)
• INLINECODE3 — Default to "starter" or "full"

Setup Gotchas

Post-Setup: Add Heartbeat Task

After setup, add the maintenance task to your HEARTBEAT.md (see "Heartbeat Maintenance" in Daily Use section).

Setup complete! Continue to Daily Use section.

📘 DAILY USE (Always relevant)

This section covers ongoing usage - reference this for all coding tasks.

Dev Team Subagents

Subagents are installed to ~/.claude/agents/. Each has a "Learn More" section with curated links to deepen expertise.

Starter Pack (Default) — 3 Core Agents

Most users only need these:

Install: ./04-install-subagents.sh (or --minimal)

Full Team (Optional) — All 10 Agents

For larger projects, install all 11 with --full-team:

Using Subagents

Interactive mode: Use the /agent slash command or natural language:
CODEBLOCK2

Non-interactive mode (-p): Use the --agent flag:
CODEBLOCK3

Note: Claude Code does NOT auto-delegate to subagents based on task type. You must explicitly specify which agent to use.

Multi-agent handoff: For tasks needing multiple specialists, use HANDOFF.md to pass context between agents. See docs/workflows.md for the full pattern.

Quick Reference

CLI Commands

Slash Commands

Keyboard Shortcuts

Shift+Tab - Toggle Plan mode (read-only exploration)
Ctrl+C    - Cancel operation
Ctrl+B    - Background task

Context Management (Critical!)

Best practices:

1. 1. /clear between unrelated tasks
2. Use Plan mode for exploration before implementing
3. Subagents isolate verbose operations
4. Create HANDOFF.md for session continuity

Project Configuration

settings.json

Create .claude/settings.json in your project:

CODEBLOCK7

CLAUDE.md

Create CLAUDE.md in your project root (Claude reads this automatically):

CODEBLOCK8

See examples/CLAUDE-template.md for a full template.

Claude-Mem (If Installed)

Check status:
CODEBLOCK9

Start if stopped:
CODEBLOCK10

Web UI: http://localhost:37777

Diagnostics & Troubleshooting

Quick diagnostics:
CODEBLOCK11

Full troubleshooting (if issues found):
CODEBLOCK12

Common issues guide: See docs/troubleshooting.md for solutions to:

• - Authentication problems (API key, OAuth, logout bugs)
• Installation issues (PATH, WSL, Node.js version)
• Network errors (firewalls, VPNs, proxies)
• Performance problems (high CPU, hangs, slow search)

Heartbeat Maintenance

Add to your HEARTBEAT.md for automatic maintenance:

CODEBLOCK13

Why this matters:

• - Skill improves over time through actual use
• Links stay current (broken ones get fixed)
• Best practices evolve with the ecosystem
• Each Clawdbot contributes back to the skill

Scripts Reference

Summary

For coding tasks:

1. 1. Use appropriate subagent for the task
2. Manage context with /clear and Plan mode
3. Run diagnostics if something breaks

Heartbeat handles:

• - claude-mem health checks
• Daily quick diagnostics
• Weekly improvement research

The dev team subagents turn Claude Code into a full development organization.