Installing Skills System

# Installing Skills System

## Overview

Installs the clank skills repository to `~/.clank/clank` and configures Claude to use it.

**For Claude agents:** Follow the "Installation Steps for Claude" section below.

**For humans:** Follow the "Quick Install" section.

## Installation Steps for Claude

When instructed to install clank, follow these steps exactly:

### Step 1: Clone Repository

**With GitHub CLI (if available):**
```bash
mkdir -p ~/.clank
cd ~/.clank
gh repo fork obra/clank --clone --remote-name upstream
```

**Without GitHub CLI:**
```bash
mkdir -p ~/.clank
cd ~/.clank
git clone https://github.com/obra/clank.git
```

### Step 2: Run Installer

```bash
cd ~/.clank/clank
./skills/meta/installing-skills/install.sh
```

This creates symlinks for skills and commands.

### Step 3: Update CLAUDE.md

Use the Edit tool to add this XML section to the very beginning of `~/.claude/CLAUDE.md`:

```xml
<EXTREMELY_IMPORTANT>
You have a personal skills wiki at ~/.claude/skills/ with proven techniques, patterns, and tools that give you new capabilities.

STOP. Before doing ANYTHING else in this conversation, read this file: skills/getting-started

That file tells you how to find and use your skills.

ONLY after reading getting-started, are you allowed to proceed with the user's request.

CRITICAL: If a skill exists for your task, you MUST use it - even if you think you're already good at that. You're not. The skill prevents mistakes you don't know you make. SKILLS EXIST AND YOU DIDN'T USE THEM = FAILED TASK.

</EXTREMELY_IMPORTANT>
```

### Step 4: Verify Installation

```bash
ls -la ~/.claude/skills
ls -la ~/.claude/commands
~/.claude/skills/getting-started/skills-search 'test.*driven'
```

### Step 5: Restart

Tell your human partner: "Installation complete. Please restart your Claude session to pick up the new CLAUDE.md configuration."

## Quick Install (for humans)

```bash
curl -fsSL https://raw.githubusercontent.com/obra/clank/main/skills/meta/installing-skills/install.sh | bash
# Then manually add CLAUDE.md section from Step 3 above
```

## What install.sh Does

1. **Validates** you're running from clank repo root (expects ~/.clank/clank)
2. **Backs up** existing `~/.claude/skills` (if exists) to timestamped backup
3. **Creates skills symlink**: `~/.claude/skills` → `~/.clank/clank/skills`
4. **Symlinks individual commands** from `~/.clank/clank/commands/*.md` to `~/.claude/commands/`
5. **Verifies** tools available (skills-search at `~/.claude/skills/getting-started/skills-search`)
6. **Prints** CLAUDE.md XML snippet to add and verification steps

## Verification

After installation, verify it worked:

```bash
# Should show symlink to ~/.clank/clank/skills
ls -la ~/.claude/skills

# Should show individual command symlinks
ls -la ~/.claude/commands/

# Test skills-search tool
~/.claude/skills/getting-started/skills-search 'test.*driven'
```

## What Gets Installed

**Skills** (`~/.claude/skills/`):
- Library of proven techniques, patterns, and tools
- Referenced with `@` syntax in code and documentation
- Searchable with `skills-search` tool

**Commands** (`~/.claude/commands/`):
- Individual symlinks to clank command files
- Slash commands for Claude (`/brainstorm`, `/write-plan`, `/execute-plan`)
- Each command references a skill using `@` syntax
- Makes common workflows one command away

**Tools** (`~/.claude/skills/getting-started/`):
- `skills-search` - Find relevant skills using grep patterns
- Logs failed searches for gap analysis

## Why Fork?

Forking lets you:
- **Customize** skills and commands for your workflow
- **Contribute** improvements back via PR (see skills/contributing-skills)
- **Stay synced** with upstream updates (`git pull upstream main`)
- **Track** your customizations in version control

## Configu