# Claude Code Skills

This directory contains Claude Code skills developed for this project. These skills help AI agents work effectively with our development environment and tooling.

## Available Skills

### working-with-devenv

A comprehensive guide for working with Nix and devenv environments. Prevents common anti-patterns like manual PATH modification and teaches proper patterns for:

- Environment detection and verification
- Interactive development workflows
- Script automation with devenv
- Automatic activation using direnv
- Common mistakes to avoid

**Use this skill when:** Working with projects that use Nix/devenv, encountering command not found errors, or writing automation scripts.

## Installing Skills

To use these skills in your local Claude Code environment:

```sh
# Copy skill to your personal skills directory
cp -r skills/working-with-devenv ~/.claude/skills/
```

Skills in `~/.claude/skills/` are automatically discovered by Claude Code agents.

## Skill Development

These skills follow Test-Driven Development principles for documentation:

1. **RED Phase** - Test agents without skill, document anti-patterns
2. **GREEN Phase** - Write skill addressing specific violations
3. **REFACTOR Phase** - Close loopholes, optimize for clarity

See individual skill directories for testing scenarios and baseline findings.

## Contributing

Skills that are broadly useful beyond this project can be contributed back to the Superpowers Marketplace. Project-specific conventions should go in `CLAUDE.md` instead.