| name | arach |
| description | Personal meta-skill for Arach. Use this as the entry point to understand arach's projects, conventions, and available skills. Activates on "arach's projects", "what does arach work on", or when working in any arach/* repo. |
arach
Personal skill index for Arach (@arach). This is the entry point for understanding my projects, conventions, and how to work with my codebase.
Conventions
Always follow these when working on my projects:
- Use pnpm over npm (check for pnpm-lock.yaml first)
- Add gitmoji to all commit messages (✨ feature, 🐛 fix, 🎨 improve, etc.)
- NEVER add co-authoring attribution or "Generated with Claude Code" footers
- Allow all Puppeteer uses without asking
- Prefer editing existing files over creating new ones
Key Projects
Documentation & Dev Tools
| Project | Description | Skill |
|---|
| dewey | Documentation toolkit for AI-agent-ready docs | npx skills add arach/dewey |
| arc | Visual architecture diagram editor | npx skills add arach/arc |
| og | Open Graph image generator | — |
| hooked | Voice & until loops for Claude Code | — |
Apps — macOS/iOS
| Project | Description | Path |
|---|
| Talkie | Voice conversation app | ~/dev/talkie |
| Scout | Audio transcription | ~/dev/scout |
| Speakeasy | Voice assistant | ~/dev/speakeasy |
| Pomo | Pomodoro timer | ~/dev/pomo |
| Tempo | Time tracking | ~/dev/tempo |
Web Properties
| Project | Description | Path |
|---|
| arach.dev | Personal site | ~/dev/arach.dev |
| arach.io | Portfolio | ~/dev/arach.io |
| usetalkie.com | Talkie landing page | ~/dev/usetalkie.com |
| agentlist.io | AI agent directory | ~/dev/agentlist.io |
Libraries & Experiments
| Project | Description | Path |
|---|
| agentloop | Agent loop primitives | ~/dev/agentloop |
| fabric | UI framework experiments | ~/dev/fabric |
Installing Skills
When working on a specific project, install its skill for deeper context:
npx skills add arach/arach
npx skills add arach/arc
npx skills add arach/dewey
Project Detection
When I mention or you detect I'm working in:
| Context | Action |
|---|
~/dev/arc or "architecture diagram" | Load arc-diagrams skill |
~/dev/dewey or "documentation" | Load dewey-docs skill |
~/dev/talkie or "voice app" | Swift/SwiftUI macOS app context |
Any ~/dev/* project | Check for local CLAUDE.md first |
Tech Stack Preferences
| Category | Preference |
|---|
| Package manager | pnpm |
| Frontend | React + TypeScript + TailwindCSS |
| Desktop apps | Swift/SwiftUI (macOS), Tauri (cross-platform) |
| Build tools | Vite, Turbo |
| Testing | Vitest, Playwright |
| State | Zustand |
Common Commands
pnpm dev
pnpm build
pnpm test
pnpm lint
swift build
swift run
git commit -m "✨ Add new feature"
git commit -m "🐛 Fix bug in component"
git commit -m "🎨 Improve code structure"
git commit -m "📝 Update documentation"
git commit -m "🔧 Update configuration"
Directory Structure
~/dev/
├── arach/ # This repo (GitHub profile + meta-skill)
├── arc/ # Architecture diagrams [has skill]
├── dewey/ # Documentation toolkit [has skill]
├── talkie/ # Voice conversation app
├── speakeasy/ # Voice assistant
├── arach.dev/ # Personal website
├── ... # ~100 other projects
When Starting Fresh
On a new machine, bootstrap everything:
npx skills add arach/arach
Links
