# Claude Code Agent Skills

These are the Agent Skills I use daily with Claude Code. They provide Claude with domain-specific expertise for common development tasks. Feel free to use, modify, and share them in your own projects.

## Available Skills

### Meta
| Skill | Description |
|-------|-------------|
| **artificer** | Creates well-structured Agent Skills for Claude Code |

### Design
| Skill | Description |
|-------|-------------|
| **token-keeper** | Enforces design system consistency when building UI components |
| **ally** | Accessibility auditing and remediation for web applications |
| **animator** | Animation and micro-interaction patterns for web interfaces |

### Development
| Skill | Description |
|-------|-------------|
| **inspector** | Performs thorough code reviews with actionable feedback |
| **historian** | Git workflow automation and best practices |
| **bug-hunter** | Testing strategies and patterns for JS/TS applications |
| **light-packer** | Guides database selection, preferring SQLite for prototypes |
| **clean-coder** | Applies SOLID, DRY, KISS, and YAGNI principles to development |

## Installation

### Install All Skills (Global - macOS)

Install all skills to your home directory so they're available in every project:

```bash
# Clone or download the repo, then:
mkdir -p ~/.claude/skills && cp -r /path/to/dylantarre/.claude/skills/* ~/.claude/skills/

# Or if you're in this repo:
mkdir -p ~/.claude/skills && cp -r .claude/skills/* ~/.claude/skills/
```

### Install a Single Skill (Global - macOS)

```bash
# Create the global skills directory
mkdir -p ~/.claude/skills

# Copy just the skill you want
cp -r .claude/skills/token-keeper ~/.claude/skills/
```

### Install for a Single Project

Copy skills to your project's `.claude/skills/` directory (these are shared with your team via git):

```bash
# Create the skills directory if it doesn't exist
mkdir -p .claude/skills

# Copy a single skill
cp -r /path/to/dylantarre/.claude/skills/token-keeper .claude/skills/

# Or copy all skills
cp -r /path/to/dylantarre/.claude/skills/* .claude/skills/
```

### Skill Locations

| Location | Scope | Shared via Git |
|----------|-------|----------------|
| `~/.claude/skills/` | All your projects (personal) | No |
| `.claude/skills/` | Current project only | Yes |

## Usage

Once installed, Claude Code automatically discovers and uses these skills when relevant. Just ask Claude to help with tasks related to the skill's domain:

- "Review this component for accessibility issues"
- "Create a test for this function"
- "Review this pull request"
- "Set up a database for this project"

## Skill Structure

Each skill is a folder containing a `SKILL.md` file with:

```yaml
---
name: skill-name
description: When Claude should use this skill
---

# Skill Content

Instructions and reference material...
```

## Creating Your Own Skills

1. Create a new folder in `.claude/skills/`
2. Add a `SKILL.md` file with YAML frontmatter
3. Include clear instructions and examples

See [Anthropic's Skills Documentation](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) for more details.

## License

MIT - These are my personal skills that I use daily. Feel free to use, modify, and share them however you like.