Add codegrid skill — multi-agent coding canvas for macOS

[isaachorowitz]

Summary

Adds a new codegrid/ skill for CodeGrid — a native macOS canvas where multiple coding agents (Claude, Codex, Gemini, Cursor, Grok, shells) run side by side in panes and collaborate via a local agent bus. The differentiator: multiple coding agents collaborating on one canvas, addressable by stable session_id, with a read → message → read protocol built for orchestration.

• Homepage: https://codegrid.app
• Token (Base): $GRID — 0x6B456E66524aEC1792013eF9DFE87e3F84311ba3 (token page)
• Launch: https://bankr.bot/launches/0x6B456E66524aEC1792013eF9DFE87e3F84311ba3

What's in the bundle

codegrid/
├── SKILL.md                              # umbrella — entry point
└── references/
    ├── using-codegrid.md                 # operating manual + control socket + deep links
    └── codegrid-agent-bus.md             # collaboration protocol + patterns + examples

• SKILL.md — umbrella with the differentiator front-loaded, install command, quickstarts for inside a pane (MCP tools: list_agents, read_pane, message_agent) and outside CodeGrid (control-socket JSON-RPC + codegrid:// deep links), and safety defaults.
• references/using-codegrid.md — mental model (canvas / pane / workspace / agent / bus), MCP tools, full control-socket JSON-RPC API (agent_list, agent_read, agent_send, open_folder, new_session, new_workspace, list_sessions), the codegrid:// URL scheme, and an operating playbook with recipes.
• references/codegrid-agent-bus.md — read → message → read protocol, orchestration patterns (delegate, review, pipeline, parallel fan-out, monitor, debate), etiquette & scope safety, loop/runaway prevention, failure-mode recovery, and worked end-to-end examples.

Install

install the codegrid skill from https://github.com/BankrBot/skills/tree/main/codegrid

Example usage

Once installed, an agent running inside a CodeGrid pane can do:

list_agents()                                       # discover sibling panes + roles
read_pane(<session_id>)                             # check state — always safe
message_agent(<session_id>,
  "[from Claude] Review src/auth.ts for security issues. Reply with a bullet
   list of findings, ranked by severity. Do not edit any files.")
… wait …
read_pane(<session_id>)                             # collect the reply

Or from outside CodeGrid (any tool / script):

SOCK="$(cat ~/.codegrid/socket-path 2>/dev/null || echo ~/.codegrid/socket)"
printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"agent_list"}' | nc -U "$SOCK"
open "codegrid://open?path=/abs/path/to/repo&type=codex"

Test plan

• SKILL.md validates with required name + description frontmatter
• Layout matches the registry convention (provider/SKILL.md + optional references/)
• Install URL resolves once merged
• References documented in the umbrella
• Reviewer can install via the documented command and the agent can answer "what is CodeGrid?" / "how do I message another agent inside CodeGrid?"

Happy to iterate on the umbrella copy or split into sub-skills if the maintainers prefer that layout. Thanks!