CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apm-communication

How APM agents write to the User, to each other and through the file-based Message Bus.

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./templates/skills/apm-communication/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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.

The body is a tight, prescriptive set of communication conventions with concrete ceilings, exact paths and file names, a worked invocation example, and an ordered ID-resolution procedure — genuinely actionable for an instruction-only skill. Bus operations are sequenced with verification steps, and the one deep-dive topic is properly split into a clearly signaled one-level reference. Only minor tightening of generic style advice and a worked example or two separate it from top marks.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive, carrying almost exclusively project-specific rules Claude could not infer (the word-ceiling table of 100/250/500, bus file clearing protocol, slug resolution order) rather than explanations of known concepts. Minor trimmable over-explanation remains — the "Wording" and "Form" bullets restate general style advice ("Use everyday words, concrete subjects and active verbs", "Put commands in code blocks") Claude already follows — so it fits anchor 4 rather than the every-token-earns-its-place bar of 5.

4 / 5

Actionability

Guidance is concrete and executable throughout: numeric reply ceilings (100/250/500 words), exact paths and file names (".apm/bus/", "task.md", "report.md", "handoff.md", "manager/"), a worked invocation example ("`apm-5-check-reports frontend-agent` in the Manager's chat"), and an ordered matching procedure ("an exact match first, then a prefix, then the closest plausible name"). It is not 5 because there is no worked example of ID resolution matching or a sample bus message, and formats are deferred to role guides — appropriate, but it leaves minor gaps.

4 / 5

Workflow Clarity

The bus protocol is an explicitly sequenced workflow with verification ("Read a bus file before writing it... verify the written content before announcing it", "After you process an incoming message, clear its file before you write your outgoing one"), reply drafting has a checkpoint ("check that it opens with the substance and fits its ceiling"), and ID resolution has ordered fallbacks with User confirmation. It is not 5 because there is no error-recovery loop when verification fails, and section 2 is a convention list rather than a sequenced process. No destructive or batch operation is involved, so no cap applies.

4 / 5

Progressive Disclosure

The ~50-line body is cleanly sectioned (1/2/3 with 3.1/3.2) with no inlined bulk that belongs elsewhere, and the single deep-dive topic is split out to a clearly signaled, one-level-deep reference ("{SKILL_DIR:apm-communication}/bus-integration.md describes how"). No bundle directories (references/, scripts/, assets/) are provided — the bundle is SKILL.md alone — so per the simple-skill guideline the well-organized structure with its one clearly signaled external reference earns the top score.

5 / 5

Total

17

/

20

Passed

Description

53%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.

The description is concise, third-person, and names a clear niche — APM agent communication across the User, peer agents, and the file-based Message Bus. Its weaknesses are the absence of any "when to use this" trigger guidance and reliance on a single generic verb ("write") with no concrete artifacts, leaving both completeness and trigger matching at the midpoint. Adding a Use-when clause and naming the file types it governs would raise it substantially.

Suggestions

Add an explicit trigger clause, e.g. "Use when writing replies to the User, composing Task Prompts/Task Reports, or exchanging messages on the Message Bus" — the missing Use-when clause currently caps completeness at 3.

Include the natural terms agents and users actually say — "task prompt", "task report", "handoff", "message bus", "reply" — to improve trigger-term coverage beyond the two domain keywords present.

Name the concrete artifacts the skill governs (Task Prompts, Task Reports, Handoff Prompts, bus files) instead of the generic "write", which would lift specificity from 3 toward 4-5.

DimensionReasoningScore

Specificity

The description names its domain ("APM agents", "file-based Message Bus") and identifies three write targets ("to the User, to each other and through the file-based Message Bus"), but the only action is the generic verb "write" — no concrete artifacts such as Task Prompts, Task Reports or Handoffs are named. It sits between anchor 2 (generic actions) and anchor 3 (domain plus 1-2 concrete actions); the three distinct channels lift it just to 3, and it is not 4 because no specific capabilities are enumerated.

3 / 5

Completeness

"How APM agents write to the User, to each other and through the file-based Message Bus" answers "what" clearly, but there is no "Use when..." clause or equivalent trigger guidance anywhere, which the rubric explicitly caps at 3. It is not 2 because the "what" is concrete and domain-specific rather than vague.

3 / 5

Trigger Term Quality

"Message Bus" and "APM agents" are relevant domain keywords a practitioner in this ecosystem would say, but common natural variations are missing — "task prompt", "task report", "handoff", "reply to the user", "communicate". This matches anchor 3 ("Some relevant keywords but missing common variations or synonyms"); it is above 2 because the terms present are specific rather than generic filler.

3 / 5

Distinctiveness Conflict Risk

"APM agents" and "file-based Message Bus" carve a clear niche that unrelated skills are unlikely to trigger, fitting anchor 4 ("Mostly distinct; minor overlap risk with closely related skills") given sibling APM guides that also involve writing files. It is not 5 because the description offers no explicit distinct triggers and relies on domain terms alone.

4 / 5

Total

13

/

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

sdi2200262/agentic-project-management

Path

templates/skills/apm-communication/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.