# Custom Claude Skills

Reusable [Claude Code](https://docs.anthropic.com/en/docs/claude-code) skills shared across all projects.

## Setup

```bash
# Clone and install
cd ~/dev/claude/custom-claude-skills
./scripts/install.sh
```

The install script creates symlinks from `~/.claude/skills/` to this repo, making all skills available in every project.

## Available Skills

| Skill | Invocation | Description |
|-------|-----------|-------------|
| reflect | `/reflect M8` | Milestone reflection — reviews conversation history, git log, and project docs to produce structured reflection artifacts across MEMORY.md, FUTURE.md, README.md, and CLAUDE.md |
| log | `/log` | End-of-session logging — captures decisions, gotchas, open questions to `memory/log/`. Prunes old reflected logs. |
| reflect-logs | `/reflect-logs` | Processes session logs into topic memory files, deduplicates, flags stale entries. Run periodically. |
| distill-best-practices | `/distill-best-practices` | Cross-project best practices distillation into `claude-foundations/best-practices/`. Interactive — proposes changes for approval. |

## Adding a New Skill

1. Create `skills/<skill-name>/SKILL.md` with YAML frontmatter and instructions
2. Run `./scripts/install.sh` to create the symlink
3. Update this README's skill table

## How Skills Work

Skills are Claude Code's extensibility mechanism. Each skill is a markdown file with:
- **YAML frontmatter** — metadata, tool restrictions, execution mode
- **Dynamic context injection** — `!`command`` blocks run at load time to pre-fetch data
- **Structured instructions** — what Claude should do when the skill is invoked

Skills in `~/.claude/skills/` are available across all projects (personal scope).

## Scripts

| Script | Purpose | When to run |
|--------|---------|-------------|
| `scripts/install.sh` | Symlinks all skills into `~/.claude/skills/` | After cloning or adding new skills |