all publishers

joelhooks

@joelhooks source repo

76 published skills

  1. ▌
    Swarm Coordination 6 · joelhooks
    Multi-agent coordination patterns for OpenCode swarm workflows. Use when work benefits from parallelization or coordination. Covers: decomposition, worker spawning, file reservations, progress tracking, and review loops.
    752 repo stars
  2. ▌
    Tdd 2 · joelhooks
    Test-Driven Development workflow with RED-GREEN-REFACTOR, lore from Kent Beck, Michael Feathers, and Ousterhout's counterpoint
    752 repo stars
  3. ▌
    Release 2 · joelhooks
    Handles version bumps and npm releases for the swarm-tools monorepo (opencode-swarm-plugin, claude-code-swarm-plugin, swarm-mail, swarm-queue). Use when: creating changesets, bumping versions, preparing releases, checking release status, debugging publish failures, verifying npm packages, or merging release PRs. Triggers: "release", "publish", "changeset", "bump version", "ship it", "new version", "create a release", "check npm", "verify publish", "/release"
    752 repo stars
  4. ▌
    Queue 2 · joelhooks
    Guide for job queue patterns in multi-agent coordination. Use when deciding between background jobs vs inline execution, submitting long-running tasks, monitoring job progress, and handling failures. Covers when to queue, job priority, retry strategies, and monitoring patterns.
    752 repo stars
  5. ▌
    Skill Creator 3 · joelhooks bundle
    Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
    752 repo stars
  6. ▌
    System Design 2 · joelhooks
    Principles for building reusable coding systems. Use when designing modules, APIs, CLIs, or any code meant to be used by others. Based on "A Philosophy of Software Design" by John Ousterhout. Covers deep modules, complexity management, and design red flags.
    752 repo stars
  7. ▌
    Always On Guidance 3 · joelhooks
    Always-on rule-oriented guidance for claude-plugin agents. Use to align behavior, tool usage, and model-specific defaults while avoiding deprecated bd/cass references. Related skills: swarm-coordination, testing-patterns.
    752 repo stars
  8. ▌
    Openclaw Messaging 2 · joelhooks
    Send messages, system events, and agent notifications through the openclaw CLI. Use when an agent needs to notify a user (Telegram, Slack, Discord), trigger another agent, broadcast updates, send system events, or coordinate agent-to-agent communication via swarmmail. Covers all three messaging layers - external channels, agent invocation, and internal swarmmail.
    752 repo stars
  9. ▌
    Swarm Coordination 4 · joelhooks
    Multi-agent coordination patterns for OpenCode swarm workflows. Use when work benefits from parallelization or coordination. Covers: decomposition, worker spawning, file reservations, progress tracking, and review loops.
    752 repo stars
  10. ▌
    Skill Creator 4 · joelhooks
    Guide for creating effective agent skills. Use when you want to create a new skill, improve an existing skill, or learn best practices for skill development. Helps codify learned patterns into reusable, discoverable skills.
    752 repo stars
  11. ▌
    Skill Generator 2 · joelhooks bundle
    Meta-skill for generating new skills with proper format and structure. Use when creating new skills for the swarm system or when agents need to generate skill scaffolds. Ensures skills follow conventions (frontmatter format, directory structure, bundled resources).
    752 repo stars
  12. ▌
    Swarm CLI 2 · joelhooks
    Swarm CLI commands for workers - hivemind memory, hive tasks, swarmmail coordination. Use when working in a swarm context. Covers: swarm memory (find/store/get/stats), swarm cells (query/create/update/close), and coordination commands.
    752 repo stars
  13. ▌
    Testing Patterns 2 · joelhooks bundle
    Patterns for testing code effectively. Use when breaking dependencies for testability, adding tests to existing code, understanding unfamiliar code through characterization tests, or deciding how to structure tests. Covers seams, dependency injection, test doubles, and safe refactoring techniques from Michael Feathers.
    752 repo stars
  14. ▌
    Swarm Coordination 5 · joelhooks bundle
    Multi-agent coordination patterns for OpenCode swarm workflows. Use when working on complex tasks that benefit from parallelization, when coordinating multiple agents, or when managing task decomposition. Do NOT use for simple single-agent tasks.
    752 repo stars
  15. ▌
    Ralph Supervisor 2 · joelhooks
    Ralph loop pattern - Claude supervises while Codex (gpt-5.3-codex) executes implementation work. Use for autonomous coding loops with fresh context per iteration, validation gates, and git-backed persistence. Tools: ralph_init, ralph_story, ralph_iterate, ralph_loop, ralph_status, ralph_cancel, ralph_review.
    752 repo stars
  16. ▌
    Always On Guidance 4 · joelhooks
    Always-on rule-oriented guidance for claude-plugin agents. Use to align behavior, tool usage, and model-specific defaults while avoiding deprecated bd/cass references. Related skills: swarm-coordination, testing-patterns.
    752 repo stars
  17. ▌
    Skill Creator 2 · joelhooks
    Guide for creating effective agent skills. Use when you want to create a new skill, improve an existing skill, or learn best practices for skill development. Helps codify learned patterns into reusable, discoverable skills.
    752 repo stars
  18. ▌
    Swarm Coordination 2 · joelhooks bundle
    Multi-agent coordination patterns for OpenCode swarm workflows. Use when working on complex tasks that benefit from parallelization, when coordinating multiple agents, or when managing task decomposition. Do NOT use for simple single-agent tasks.
    752 repo stars
  19. ▌
    Always On Guidance 2 · joelhooks
    Always-on rule-oriented guidance for claude-plugin agents. Use to align behavior, tool usage, and model-specific defaults while avoiding deprecated bd/cass references. Related skills: swarm-coordination, testing-patterns.
    752 repo stars
  20. ▌
    Swarm Coordination 3 · joelhooks
    Multi-agent coordination patterns for OpenCode swarm workflows. Use when work benefits from parallelization or coordination. Covers: decomposition, worker spawning, file reservations, progress tracking, and review loops.
    752 repo stars
  21. ▌
    Openclaw Codex Ralph · joelhooks bundle
    Ralph Codex — OpenClaw Plugin
    752 repo stars
  22. ▌
    Uncomplect · joelhooks bundle
    Pressure-test a stateful system or replacement design through Rich Hickey's simplicity and complection, Greg Young's deletability, Ousterhout's deep modules, DDD boundaries, typed effects, and explicit lifecycle modeling. Use when the user asks "what would Rich Hickey do", "optimize for deletion", "make this simpler", "define this error out of existence", "review this state machine", "design it twice", or wants to replace a working prototype without preserving its accidental architecture.
    752 repo stars
  23. ▌
    Aa Book · joelhooks
    Anna's Archive acquisition helper. Search books, download through fast partner pages with browser auth, convert epub/mobi to PDF when needed, transfer to NAS, and ingest into the docs brain. Use when: (1) user asks to find/download a book, (2) user asks for Anna's Archive search, (3) user needs a book file staged for downstream ingest. Triggers: "find book", "download book", "search anna", "aa-book", "grab the books".
    752 repo stars
  24. ▌
    Secret Management · joelhooks
    Portable credential management for AI agents using age encryption, session-scoped leases, auto-rotation, and killswitch. Use this skill when agents need secure, time-bounded access to API keys, tokens, or credentials without direct exposure to plaintext secrets.
    752 repo stars
  25. ▌
    Pi Bellwether · joelhooks
    Control Herdr workspaces, tabs, panes, coding agents, and non-blocking direct-socket watches from Pi. Use when Joel explicitly asks to inspect or control Herdr, create pane topology, prompt a Herdr agent, read output, or arm an agent-state or pane-output watch.
    752 repo stars
  26. ▌
    Pi Cmux · joelhooks
    Control cmux terminal multiplexer from pi — read other terminal screens, send commands to other workspaces, manage panes/splits, set sidebar status/progress, send notifications, and open browser surfaces. Use when asked to: check what's running in another terminal, send a command to another pane, split the workspace, show progress in the sidebar, notify the user, open a URL in a browser pane, orchestrate multi-workspace workflows, or interact with cmux in any way. Triggers on: 'cmux', 'other terminal', 'other workspace', 'read screen', 'send command to', 'split pane', 'sidebar status', 'progress bar', 'notify', 'browser pane', 'terminal multiplexer'.
    752 repo stars
  27. ▌
    Todoist · joelhooks
    Manage Todoist tasks, projects, comments, reminders, and activity via the todoist-cli agent CLI. Use when: 'add a task', 'what's due today', 'check my inbox', 'complete a task', 'todoist', 'todo', 'task list', 'what did I finish', 'add a comment', 'set a reminder', 'daily review', 'search tasks', 'move task to project', 'what's overdue', or any task management request. All output is HATEOAS JSON with next_actions — parse result.tasks, result.comments, etc.
    752 repo stars
  28. ▌
    Shitbox Triage · joelhooks
    Front inbox janitor for Joel's personal shitbox: Brain-mapped executive digests, contextual grouping, safe archive sweeps, and Front thread links. Use when asked to clean the shitbox, summarize inbox, run a digest, sweep personal Front, or tune inbox interest rules.
    752 repo stars
  29. ▌
    Shitrat Maintain · joelhooks
    Maintain, install, update, doctor, and release a ShitRat familiar across supported harnesses.
    752 repo stars
  30. ▌
    Shitrat Github · joelhooks
    Post GitHub issue comments, PR reviews, and small file commits as the ShitRat GitHub App (`shitratgit[bot]`) instead of Joel. Use when reviewing PRs, commenting on issues, doing smoke tests, committing repo files through the GitHub API, or any workflow where GitHub authorship should be ShitRat.
    752 repo stars
  31. ▌
    Source Mirror · joelhooks
    Clone/update project-local source mirrors under .agent-sources, keep them out of commits, and read docs/source before making API claims.
    752 repo stars
  32. ▌
    Ose Rules Access · joelhooks
    Query JoelClaw docs/PDF Brain for Old School Essentials rules while preserving Referee-only access and avoiding public corpus leakage.
    752 repo stars
  33. ▌
    Brain Maintenance · joelhooks
    Maintain Cloudflare Agent Dungeon .brain notes as the durable project graph using PARA placement and source-backed receipts.
    752 repo stars
  34. ▌
    Pi Notes · joelhooks
    Create or operate local product-namespaced Pi review documents that can send feedback turns back to the spawning Pi session.
    752 repo stars
  35. ▌
    Excalidraw Dag · joelhooks
    Create very clean, legible Excalidraw DAG/system diagrams for pi-notes. Use for architecture diagrams, feedback loops, data/control flow, state/lifecycle maps, or any request for a simple Excalidraw diagram where readability matters.
    752 repo stars
  36. ▌
    Brain Component Composition · joelhooks bundle
    Design and maintain composable data-backed Brain MDSvX components for pi-notes. Use when creating or editing `.brain/**/*.svx`, `.brain/components`, `.brain/data`, pi-notes Document Host components, review surfaces, or notes that should render JSONL, SQLite, Postgres, remote data, or reusable web shapes.
    752 repo stars
  37. ▌
    Shortlink Qr · joelhooks
    Create joel.dev shortlinks and QR assets. Use when Joel asks for a QR code, stage/demo shortlink, joel.dev redirect, link label that looks good in phone camera UI, or a copyable QR asset.
    752 repo stars
  38. ▌
    Pi Tui Design · joelhooks bundle
    Create distinctive, crafted TUI components for pi using @mariozechner/pi-tui and @mariozechner/pi-coding-agent. Use when building interactive terminal UIs — custom components, overlays, dialogs, dashboards, widgets, data visualizations, animated elements, game-like interfaces, or any visual TUI work inside pi extensions or custom tools. Triggers on: 'build a TUI component', 'make a dashboard', 'create an overlay', 'interactive widget', 'terminal UI', 'custom component', 'pi-tui', or any request to create visual, interactive terminal interfaces. Also use when beautifying or redesigning existing TUI components.
    752 repo stars
  39. ▌
    Linear Tracker · joelhooks
    Resolve project-local issue tracker routing and publish Linear issues safely. Use before creating Linear issues, PRDs, phase breakdown issues, or when deciding whether Linear/GitHub/local docs is the configured tracker. Enforces capability ≠ routing: Linear requires project-local policy, team association, auth, and verified readback.
    752 repo stars
  40. ▌
    Session Search · joelhooks
    Search and verify Joel's Pi, Claude, Codex, Cursor, Grok, and OpenCode session history. Use when asked to recover prior context, find exact transcript evidence, inspect session receipts, continue old work, or verify capture health. Prefer flowing recall before raw transcript search when the question is about prior decisions or project memory.
    752 repo stars
  41. ▌
    Session Capture · joelhooks
    Historical pointer for the retired Codex-to-Central capture plugin. Use only to inspect legacy state during migration; current capture belongs to the joelclaw flowing-memory host adapter.
    752 repo stars
  42. ▌
    Review · joelhooks
    Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".
    752 repo stars
  43. ▌
    Implement · joelhooks
    Implement a piece of work based on a PRD or set of issues.
    752 repo stars
  44. ▌
    Preview · joelhooks
    Run a dry run of a Rubicon programming write batch via programming_write_dry_run to get a confirmationToken and a human-readable preview of the change before anything is published. Use this as stage 3 of the Rubicon programming pipeline, after programming-inference and before publish.
    752 repo stars
  45. ▌
    Publish · joelhooks
    Publish a previewed Rubicon programming write batch via programming_write_publish using the confirmationToken from the preview step. Use this as stage 4 (final) of the Rubicon programming pipeline, after the coach has explicitly approved the preview.
    752 repo stars
  46. ▌
    Sheet Read · joelhooks
    Read rows from the coach's Programming Source Sheet and/or Movement Source Sheet using gogcli, resolving the real spreadsheet ID from local plugin data instead of any hardcoded value. Use this as stage 1 of the Rubicon programming pipeline, before programming-inference.
    752 repo stars
  47. ▌
    Programming Inference · joelhooks
    Transform raw Programming/Movement Source Sheet rows into Rubicon's programming write operations (create_node, patch_node, create_edge, patch_edge), applying conjugate-method coaching conventions and resolving movement IDs via movement_catalog_search. Use this as stage 2 of the Rubicon programming pipeline, after sheet-read and before preview.
    752 repo stars
  48. ▌
    Loopcraft Ta · joelhooks
    Local teaching assistant for a Loopcraft learner workspace. Use when building the connected issue-progress loop, shaping the local issue checker control surface, choosing the next step, setting up pnpm/TypeScript/tsgo/oxlint/oxfmt/Ultracite and Git/Lefthook guardrails, steering idiomatic Effect and XState usage from the .agent_sources mirrors, or translating between Pi, Claude Code, Codex, and other agent harnesses.
    752 repo stars
  49. ▌
    Grill With Docs · joelhooks
    Interview the plan one sharp question at a time, inspect local docs before asking, and save clear decisions back into the right repo docs.
    752 repo stars
  50. ▌
    Pi Subagents · joelhooks
    Delegate work to builtin or custom subagents with single-agent, chain, parallel, async, forked-context, and intercom-coordinated workflows. Use for advisory review, implementation handoffs, and multi-step tasks where a single agent should stay in control while other agents contribute context, planning, or execution.
    752 repo stars
  51. ▌
    Core · joelhooks bundle
    Core Native SDK guide for AI agents. Read this before explaining the Native SDK or changing a Native SDK app. Covers the mental model (native-rendered apps by default, WebView shells as a coexisting architecture), project structure, app.zon, App and Runtime patterns, frontend integration, web engines, JavaScript bridge commands, permissions, windows, WebViews, dialogs, packaging, debugging, testing, and when to load deeper references. For authoring native-rendered UI (Native markup .native views, Model/Msg/update, UiApp), load the native-ui skill. Use when the user asks what the Native SDK is, how to build or modify an app, how to package or debug it, or how to add native capabilities.
    752 repo stars
  52. ▌
    Native Sdk · joelhooks
    Discovery skill for the Native SDK, the complete toolkit for building native desktop applications - views are declarative Native markup (.native), logic is plain Zig, and the toolkit's own engine renders every pixel, with WebView surfaces as the optional web-content path. Use when the user asks what the Native SDK is, how to build a Native SDK app, author native UI, scaffold an app, configure app.zon, add bridge commands, embed web content, package an app, test a running app, or automate a Native SDK app.
    752 repo stars
  53. ▌
    Automation · joelhooks
    Automation and verification guide for running Native SDK apps. Use when the user asks to test a running app, inspect runtime state, list windows, wait for readiness, drive widgets, take deterministic screenshots, send bridge commands, debug why automation is not connected, create smoke tests, or verify a Native SDK example in a GUI-capable session.
    752 repo stars
  54. ▌
    Zig · joelhooks
    Zig 0.16 idioms for Native SDK code, indexed by compile error. Load when `zig build` fails on std APIs with errors like "struct 'fs' has no member named 'cwd'", "struct 'array_list.Aligned(u8,null)' has no member named 'init'", "struct 'std' has no member named 'io'", "no member named 'GeneralPurposeAllocator'", "no member named 'getEnvMap'", or "invalid format string" - the signature of code written for Zig 0.15 or earlier. Covers main(std.process.Init), std.Io file IO and writers, ArrayList, process spawning, environment, clocks and sleep, sockets, custom formatting, and build.zig module shapes, each as this SDK writes them.
    752 repo stars
  55. ▌
    Pi Agent · joelhooks bundle
    Pi agent runtime integration for Cloudflare. Use when implementing the agent loop, tools, extensions, session trees, or multi-provider LLM calls. Triggers on Pi, agent runtime, tool calling, streaming, session tree, extensions, self-extending agent.
    752 repo stars
  56. ▌
    D1 Patterns · joelhooks
    D1 database patterns for encrypted agent records. Use when implementing schema, storing/querying encrypted records, migrations, or working with the records table. Triggers on D1, database, schema, records table, SQL, encrypted storage.
    752 repo stars
  57. ▌
    IOS Publish · joelhooks
    Publish the native iOS app to TestFlight from this repo. Use when archiving/exporting/uploading builds, bumping versions, checking App Store Connect processing status, or fixing common upload failures.
    752 repo stars
  58. ▌
    Cloudflare Do · joelhooks
    Cloudflare Durable Objects patterns for agent state. Use when implementing agent DOs, WebSocket handling, hibernation, storage API, alarms, or DO-to-DO communication. Triggers on Durable Object, DO state, WebSocket server, hibernation, agent persistence.
    752 repo stars
  59. ▌
    Vectorize Search · joelhooks
    Vectorize semantic search patterns for agent memory. Use when implementing embedding generation, semantic search, memory retrieval, or working with the Vectorize API. Triggers on Vectorize, embeddings, semantic search, vector database, similarity search.
    752 repo stars
  60. ▌
    Envelope Encryption · joelhooks
    Envelope encryption patterns with X25519 for agent memories. Use when implementing key generation, DEK management, encrypting/decrypting records, key rotation, or sharing encrypted data between agents. Triggers on encryption, X25519, DEK, envelope encryption, key exchange, crypto.
    752 repo stars
  61. ▌
    Atproto Deploy · joelhooks
    Deploy the atproto-agent-network project. Two separate Cloudflare Workers must be deployed independently — the network worker (API + agents) and the dashboard worker (highswarm.com). Use when deploying changes, fixing the dashboard, or updating agent configs.
    752 repo stars
  62. ▌
    IOS App · joelhooks
    Build and maintain the native iOS client inside this turborepo (XcodeGen, SwiftUI, WebSocket feed). Use when creating/updating the iOS app, wiring turbo tasks, or documenting iOS workflows.
    752 repo stars
  63. ▌
    Zap CLI · joelhooks
    zap observability CLI for agent debugging. Use when implementing event logging, log viewing, query presets, decision traces, or network health monitoring. Triggers on zap, observability, logging, decision traces, debugging, agent events.
    752 repo stars
  64. ▌
    Tdd · joelhooks
    Test-Driven Development workflow with RED-GREEN-REFACTOR, lore from Kent Beck, Michael Feathers, and Ousterhout's counterpoint
    752 repo stars
  65. ▌
    Release · joelhooks
    Handles version bumps and npm releases for the swarm-tools monorepo (opencode-swarm-plugin, claude-code-swarm-plugin, swarm-mail, swarm-queue). Use when: creating changesets, bumping versions, preparing releases, checking release status, debugging publish failures, verifying npm packages, or merging release PRs. Triggers: "release", "publish", "changeset", "bump version", "ship it", "new version", "create a release", "check npm", "verify publish", "/release"
    752 repo stars
  66. ▌
    Queue · joelhooks
    Guide for job queue patterns in multi-agent coordination. Use when deciding between background jobs vs inline execution, submitting long-running tasks, monitoring job progress, and handling failures. Covers when to queue, job priority, retry strategies, and monitoring patterns.
    752 repo stars
  67. ▌
    Skill Creator · joelhooks bundle
    Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
    752 repo stars
  68. ▌
    System Design · joelhooks
    Principles for building reusable coding systems. Use when designing modules, APIs, CLIs, or any code meant to be used by others. Based on "A Philosophy of Software Design" by John Ousterhout. Covers deep modules, complexity management, and design red flags.
    752 repo stars
  69. ▌
    Always On Guidance · joelhooks
    Always-on rule-oriented guidance for claude-plugin agents. Use to align behavior, tool usage, and model-specific defaults while avoiding deprecated bd/cass references. Related skills: swarm-coordination, testing-patterns.
    752 repo stars
  70. ▌
    Openclaw Messaging · joelhooks
    Send messages, system events, and agent notifications through the openclaw CLI. Use when an agent needs to notify a user (Telegram, Slack, Discord), trigger another agent, broadcast updates, send system events, or coordinate agent-to-agent communication via swarmmail. Covers all three messaging layers - external channels, agent invocation, and internal swarmmail.
    752 repo stars
  71. ▌
    Swarm Coordination · joelhooks
    Multi-agent coordination patterns for OpenCode swarm workflows. Use when work benefits from parallelization or coordination. Covers: decomposition, worker spawning, file reservations, progress tracking, and review loops.
    752 repo stars
  72. ▌
    Skill Generator · joelhooks bundle
    Meta-skill for generating new skills with proper format and structure. Use when creating new skills for the swarm system or when agents need to generate skill scaffolds. Ensures skills follow conventions (frontmatter format, directory structure, bundled resources).
    752 repo stars
  73. ▌
    Swarm CLI · joelhooks
    Swarm CLI commands for workers - hivemind memory, hive tasks, swarmmail coordination. Use when working in a swarm context. Covers: swarm memory (find/store/get/stats), swarm cells (query/create/update/close), and coordination commands.
    752 repo stars
  74. ▌
    Testing Patterns · joelhooks bundle
    Patterns for testing code effectively. Use when breaking dependencies for testability, adding tests to existing code, understanding unfamiliar code through characterization tests, or deciding how to structure tests. Covers seams, dependency injection, test doubles, and safe refactoring techniques from Michael Feathers.
    752 repo stars
  75. ▌
    Ralph Supervisor · joelhooks
    Ralph loop pattern - Claude supervises while Codex (gpt-5.3-codex) executes implementation work. Use for autonomous coding loops with fresh context per iteration, validation gates, and git-backed persistence. Tools: ralph_init, ralph_story, ralph_iterate, ralph_loop, ralph_status, ralph_cancel, ralph_review.
    752 repo stars
  76. ▌
    Effect TS · joelhooks bundle
    Write idiomatic Effect v4 TypeScript following official best practices from effect-solutions and the Effect source. Use when writing, reviewing, or refactoring Effect code: services (ServiceMap.Service), layers and dependency injection, error handling (Schema.TaggedErrorClass), data modeling (Schema.Class, branded types, variants), testing (@effect/vitest), HTTP clients (effect/unstable/http), CLI tools (effect/unstable/cli), config, observability, and project setup. Triggers on: 'Effect', 'effect-ts', '@effect/', 'Schema', 'ServiceMap', 'Layer', 'Effect.gen', 'Effect.fn', 'TaggedError', 'branded types', or any Effect-TS related code.
    752 repo stars