Back to skills
extension
Category: AI Agent CapabilitiesNo API key required

arach

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.

personAuthor: jakexiaohubgithub

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:

# Install all arach skills (this meta-skill)
npx skills add arach/arach

# Install specific project skills
npx skills add arach/arc        # Architecture diagrams
npx skills add arach/dewey      # Documentation toolkit

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

# Development
pnpm dev          # Start dev server
pnpm build        # Production build
pnpm test         # Run tests
pnpm lint         # Lint code

# Swift/macOS
swift build       # Build Swift package
swift run         # Run in debug mode

# Git (always with gitmoji)
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:

# 1. Install this meta-skill
npx skills add arach/arach

# 2. Claude now knows all projects and can install specific skills as needed

Links