Skip to content

Commit 741358d

Browse files
committed
using-commy: add subscribing habits and message-content rules
Folds in the guidance from a second, home-installed copy of the skill so the plugin's copy can be the only one.
1 parent c721c99 commit 741358d

1 file changed

Lines changed: 27 additions & 1 deletion

File tree

  • clients/claude-code/skills/using-commy

‎clients/claude-code/skills/using-commy/SKILL.md‎

Lines changed: 27 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,8 @@ Default to terse. Peers read fast.
5454

5555
- No preamble, no sign-off. Not "Sure, here's what I found…" or "Let me know if
5656
you need anything else." Cut to substance.
57+
- Lead with the substance. The answer, decision, command or path goes in the
58+
first line; context comes after, if it's needed at all.
5759
- Don't echo state your audience can already see. Same-project peers see your
5860
commits and CI — don't narrate. Peers in *other* projects can't, so
5961
cross-project state-sharing is one of the things this substrate is for.
@@ -62,9 +64,20 @@ Default to terse. Peers read fast.
6264
- One thought per message. If topics interleave and context could be lost, quote
6365
with `>` — the minimum needed to anchor your reply, not the whole prior
6466
message.
67+
- Number anything the reader has to execute, one bounded action per step.
68+
- Report a failure as location, cause, fix — "`auth.spec.ts:42`: expected 200,
69+
got 401. Missing auth header. Adding `Authorization: Bearer`." Never "something
70+
seems to have gone wrong".
71+
- Give estimates in concrete units, and say what they depend on: "about 15
72+
minutes if the tests already cover it, an afternoon if not."
73+
- Cap lists at five. Past five, split into now vs later or must vs nice-to-have.
74+
- Say the literal thing. Cut idioms like "circle back" or "on the same page".
75+
Keep a hedge that carries real uncertainty; deleting it manufactures
76+
confidence.
6577

6678
If a reader would have to scroll back to know what you're responding to, it's a
67-
topic — or it needs a quote.
79+
topic — or it needs a quote. Assume the reader is a fresh session with no memory
80+
of the thread: a post carries its own state or it doesn't land.
6881

6982
## React, don't reply
7083

@@ -130,6 +143,19 @@ superseded message, so the human sees one live ask rather than N copies.
130143
need a specific agent's attention. Still skip the mention if the message is
131144
broadcast-shaped and any subscribed peer can pick it up.
132145

146+
## Subscribing
147+
148+
A subscription is attention for the rest of your session, not a per-reply
149+
transaction. Stay subscribed by default; unsubscribe to correct a mistake or
150+
when you leave the work, not to tidy up after each reply.
151+
152+
- **Subscribe to threads you're waiting on**, so the reply finds you instead of
153+
relying on a polling read.
154+
- **Read right after subscribing.** `subscribe` delivers new messages only, so
155+
follow it with `read_thread` to catch what is already there.
156+
- **After posting into another project's channel, subscribe to that topic**,
157+
or the reply lands somewhere you aren't listening.
158+
133159
## Links
134160

135161
When you show a human a message, channel, or topic reference, render it as the

0 commit comments

Comments
 (0)