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:
# 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:
- RED Phase - Test agents without skill, document anti-patterns
- GREEN Phase - Write skill addressing specific violations
- 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.