Skip to content
iaKPublic

About

Claude Code plugin marketplace: reply-style contract — be brief, number subjects, letter questions, delegate to background subagents, always end with a status label.

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

9 Commits

Folders and files

Repository files navigation

skills

A Claude Code plugin marketplace.

Install

/plugin marketplace add iaK/skills
/plugin install communication-protocol@iak-skills

Then restart Claude Code (or run /reload-plugins) so the SessionStart hook fires.

Plugins

Plugin What it does
communication-protocol A reply-style contract: be brief, number every subject, letter every question, delegate real work to background subagents, and end every reply with a one-line status label that says whether the user has to act.

communication-protocol

The problem it solves: an agent that is busy implementing is an agent you cannot reach. You want to add a detail or change the scope mid-flight, and instead you wait out a wall of tool calls. This protocol makes staying available part of the job.

Five rules:

  1. Be brief. Lead with the decision. Cut post-mortems, self-criticism, and restatements of things already visible in the code.
  2. Number your subjects (1., 2., 3.) so you can reply "expand 2" or "3 is wrong".
  3. Letter your questions (A., B., C.) so you can answer "A: yes, B: option 2".
  4. Delegate the work. Anything past a ~5-tool-call floor goes to a background subagent with a stand-alone brief, and Claude comes straight back to you. Includes the escalation clause that lets a subagent ask a question without deadlocking, plus cost rules for subagent context (never poll CI from a fat implementing agent, never resume a finished one for anything big).
  5. Always end with a label — ▌ OVER TO YOU or ▌ NOTHING FOR YOU, answering one question: do you have to do anything? Under it, a one-line status (which background agents are still running, or that nothing is), then a single lettered list of everything you have to act on — tasks and questions in one run, so numbers stay reserved for the body above. One glance tells you whether you're needed and whether work is still in flight.

It ships as both a skill (invocable as /communication-protocol) and a SessionStart hook that loads the protocol into every session automatically. If you only want it on demand, delete plugins/communication-protocol/hooks/hooks.json in a fork — Claude Code picks that file up by convention, so removing the file is what disables the hook.

Making it yours

The protocol is opinionated on purpose. Fork it and edit plugins/communication-protocol/skills/communication-protocol/SKILL.md — the parts most people will want to change are the brevity threshold, the delegation cost floor, and the label wording.

License

MIT

About

Claude Code plugin marketplace: reply-style contract — be brief, number subjects, letter questions, delegate to background subagents, always end with a status label.

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages