CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

artifact-message-bus

Coordinate multi-agent work through durable artifacts in git instead of chat. Use this whenever a task involves sending a message to another agent, agent mailboxes or handoffs, claiming work from a shared queue, notifying another agent or crew (OpenClaw, Grok Bot, Claude Code, Codex, Gas Town/Gas City workers) that work is ready, or whenever the user mentions the artifact bus, message bus, agent mail, beads mail, doorbells, or pings between agents — even if they don't say "bus" explicitly.

Quality

98%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally well-crafted skill body: dense with novel, skill-specific semantics and free of filler, fully executable workflows with explicit race/recovery handling, and a clean overview-to-reference split that was verified against the actual bundle. No dimension shows anchor-level weaknesses.

DimensionReasoningScore

Conciseness

Lean throughout: uses git/commits/push without explaining them, and every section (Five Laws, backend choice, message format, send/receive loops, doorbells, security, hygiene) is novel protocol semantics Claude could not infer. No padded or over-explained passages; not 4 because there are no trimmable instances of over-explanation.

5 / 5

Actionability

Fully executable guidance: exact `.bus/` directory layout, msg-id naming scheme, a complete copy-paste-ready message template with all fields, the exact commit format 'bus: <to> ← <from>: <subject> [<id>]', concrete git commands for claim/complete, and the exact doorbell format 'bus: check <repo>'. The common cases are covered end-to-end without pseudocode.

5 / 5

Workflow Clarity

Both multi-step workflows are clearly sequenced with explicit validation and feedback loops: 'If push is rejected, pull --rebase and push again', 'Push rejected → someone else claimed or the file moved; pull and continue. You do not own a message until your claim push lands', plus blocked-state handling (state: input-required) and crash recovery (janitor returns stale claims after 24h). Claim-push atomicity acts as the ownership checkpoint.

5 / 5

Progressive Disclosure

The body is a genuine overview; deep material (full field semantics, beads and GitHub-issue mappings, claim-race walkthroughs, recovery, worked examples) is correctly placed in the verified one-level-deep references/protocol.md, clearly signaled with when-to-read guidance ('Read it before implementing a new bus client or debugging claim conflicts'). scripts/bus.sh is referenced with its subcommand list and purpose, and both bundle files exist on disk.

5 / 5

Total

20

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete capability statement, explicit and thorough 'Use when' triggers with synonyms and named platforms, and a distinct niche. The only weakness is that the action list covers the send/notify/claim side of the protocol while omitting the receive/complete/report side, which is why specificity sits at 4 rather than 5.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Coordinate multi-agent work through durable artifacts in git', 'sending a message to another agent', 'agent mailboxes or handoffs', 'claiming work from a shared queue', 'notifying another agent or crew' — but coverage has minor gaps: the receiving/processing/completing side of the protocol is not mentioned. Anchor 4 ('several specific actions; minor gaps') fits better than 5, which demands comprehensive coverage.

4 / 5

Completeness

Explicitly answers both: what ('Coordinate multi-agent work through durable artifacts in git instead of chat') and when ('Use this whenever a task involves...' with concrete trigger phrases). Matches the anchor-5 example structure exactly; not 4 because the 'when' clause is explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage with synonyms: 'agent mailboxes', 'handoffs', 'claiming work from a shared queue', 'artifact bus, message bus, agent mail, beads mail, doorbells, or pings between agents', plus named platforms (OpenClaw, Grok Bot, Claude Code, Codex, Gas Town/Gas City) and the explicit catch-all 'even if they don't say "bus" explicitly'. No natural phrasing a user would say is missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche — durable git-artifact coordination between agents — with distinct triggers (bus, agent mail, doorbells, pings between agents, named crews) that no generic skill would claim. Minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

phatblat/dotfiles

Path

.agents/skills/artifact-message-bus/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.