CtrlK
BlogDocsLog inGet started
Tessl Logo

coordinator-source-of-truth

The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived/append-only, who may write each one, who may read each one, and the precedence rules when they conflict. Squad coordinator loads this on demand when it needs to resolve a write conflict, decide where a piece of state belongs, or answer a 'who owns this file' question.

76

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is coordinator-source-of-truth in github/gh-aw

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.

Excellent reference-style content: a precise, information-dense table plus explicit precedence rules, with no wasted tokens and no validation-sensitive workflow that would require checkpoints. It is appropriately self-contained — no bundle splitting is warranted at this size.

DimensionReasoningScore

Conciseness

The body is a dense 18-row table plus four terse rules and two short orientation notes — zero padding, no explanation of concepts Claude already knows, every line load-bearing. Not 4: there are no over-explanations that could be trimmed.

5 / 5

Actionability

Fully concrete guidance for an instruction/reference skill: exact paths (e.g., `.squad/agents/{name}/charter.md`), per-file write/read permissions by role, and decision-ready rules ("If `squad.agent.md` and any other file conflict, `squad.agent.md` wins"). An agent can adjudicate any ownership or conflict question directly from this content; per the code-vs-instruction note, the absence of code is not penalized because the guidance is actionable.

5 / 5

Workflow Clarity

A single-purpose lookup/adjudication skill with no multi-step process and no destructive or batch operations, so the simple-skill exception applies: the single action (consult the hierarchy, apply the precedence rules) is unambiguous, and edge behavior is spelled out (corrections go in "a new entry that references the prior one"). Not 4: nothing about the resolution procedure is left implicit.

5 / 5

Progressive Disclosure

The skill is well under 50 lines, self-contained, and needs no external references (no bundle files exist and none are referenced); its sections (load-when note, state-backend note, file hierarchy, rules) are clearly organized and easy to navigate, which scores 5 under the small-skill note. Not 4: at this size nothing belongs in a separate file.

5 / 5

Total

20

/

20

Passed

Description

92%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: third-person, concrete, and comprehensive on capabilities, with an explicit multi-trigger when-clause. Its only weakness is trigger-term coverage that leans on conceptual phrases rather than the literal file paths a user or coordinator would mention.

Suggestions

Add one or two literal file-path triggers (e.g., ".squad/decisions.md", "squad.agent.md") so the description fires when those paths are named directly.

Include natural synonym variations such as "file ownership" or "which file wins" to round out the trigger vocabulary.

DimensionReasoningScore

Specificity

Enumerates five concrete capabilities verbatim — "which files are authoritative, which are derived/append-only, who may write each one, who may read each one, and the precedence rules when they conflict" — with comprehensive coverage and no vague filler. Score 4 would require minor coverage gaps, and none exist: the enumeration covers every axis the skill delivers.

5 / 5

Completeness

Explicitly answers both "what" ("The complete file-by-file source-of-truth hierarchy... and the precedence rules when they conflict") and "when" ("loads this on demand when it needs to resolve a write conflict, decide where a piece of state belongs, or answer a 'who owns this file' question"). The when-clause carries three concrete trigger phrases, matching the top anchor rather than the merely-serviceable score 4.

5 / 5

Trigger Term Quality

Natural trigger phrasing is present ("resolve a write conflict", "decide where a piece of state belongs", the quoted user-voice question "who owns this file"), giving good keyword coverage. Not 5: it omits concrete file-path triggers (e.g., `.squad/decisions.md`, `squad.agent.md`) and synonym variations a user might actually say.

4 / 5

Distinctiveness Conflict Risk

The description is narrowly scoped to Squad's internal file governance with domain-specific terminology ("source-of-truth hierarchy", "append-only", "who may write"), giving it a clear niche with minimal overlap risk against any other skill.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
bradygaster/squad
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.