malpercio.dev
WIP! A BB-style forum, on the ATmosphere!
We're still working... we'll be back soon when we have something to show off!
node
typescript
hono
htmx
atproto
1# Claude Code Skills
2
3This directory contains Claude Code skills developed for this project. These skills help AI agents work effectively with our development environment and tooling.
4
5## Available Skills
6
7### working-with-devenv
8
9A comprehensive guide for working with Nix and devenv environments. Prevents common anti-patterns like manual PATH modification and teaches proper patterns for:
10
11- Environment detection and verification
12- Interactive development workflows
13- Script automation with devenv
14- Automatic activation using direnv
15- Common mistakes to avoid
16
17**Use this skill when:** Working with projects that use Nix/devenv, encountering command not found errors, or writing automation scripts.
18
19## Installing Skills
20
21To use these skills in your local Claude Code environment:
22
23```sh
24# Copy skill to your personal skills directory
25cp -r skills/working-with-devenv ~/.claude/skills/
26```
27
28Skills in `~/.claude/skills/` are automatically discovered by Claude Code agents.
29
30## Skill Development
31
32These skills follow Test-Driven Development principles for documentation:
33
341. **RED Phase** - Test agents without skill, document anti-patterns
352. **GREEN Phase** - Write skill addressing specific violations
363. **REFACTOR Phase** - Close loopholes, optimize for clarity
37
38See individual skill directories for testing scenarios and baseline findings.
39
40## Contributing
41
42Skills that are broadly useful beyond this project can be contributed back to the Superpowers Marketplace. Project-specific conventions should go in `CLAUDE.md` instead.