CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

87%

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

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.

A well-structured, high-signal reference: the authority table and precedence rules are concrete and every row earns its place. The main gaps are minor — some duplication between the opening blockquote and the description, a wordy override paragraph, and dangling references to external procedures (the casting-transactions writer, the archive-and-initialize guide) that are never inlined or located.

Suggestions

Tighten the opening blockquote so it does not restate the frontmatter description's trigger list verbatim, and compress the 'Waza support-review override' paragraph into table rows or a short bulleted override list (conciseness).

Add one or two sentences (or a link) locating and summarizing the casting-transactions locked SDK writer and the approved archive-and-initialize maintenance procedure, since rule 5 and rule 6 currently defer to them without saying where they live (actionability).

Add a brief 3-4 step 'how to adjudicate a conflict' sequence (identify the file in the table -> check Who May Write -> apply precedence rules 1-6 -> record the outcome) so the lookup workflow has an explicit sequence with checkpoints (workflow clarity).

DimensionReasoningScore

Conciseness

The body is dense and reference-grade — the 20-row table and terse rules earn their tokens, and nothing explains concepts Claude already knows. Minor trimmable material remains: the opening blockquote partially duplicates the description's trigger list, and the 'Waza support-review override' paragraph is wordy. Matches 'efficient; minor instances of over-explanation that could be trimmed', not the lean score-5 anchor.

4 / 5

Actionability

Guidance is concrete and directly usable: exact paths (.squad/decisions.md, .squad/casting/registry.json), exact state tools (squad_state_append), and executable decision rules ('Corrections go in a new entry that references the prior one'; 'use an equivalent atomic backend operation or stop on non-local storage'). Falls short of fully copy-paste-ready score 5 only because it defers to external procedures ('.squad/casting-transactions.md's locked SDK writer', 'the guide's explicit approved archive-and-initialize maintenance procedure') without inlining or linking what those entail.

4 / 5

Workflow Clarity

As a lookup/adjudication reference, precedence is explicitly sequenced (rule 1: 'squad.agent.md wins') and the risky paths carry explicit guards and stop conditions ('managed-pair corruption or a missing manifest must never trigger that path'). However, there is no explicit step-by-step adjudication procedure or validation checkpoint for the conflict-resolution workflow itself, so it sits at 'clear sequence with most checkpoints present; minor validation gaps' rather than the checklist-level score-5 anchor.

4 / 5

Progressive Disclosure

A single self-contained ~49-line body, well-organized into routing note, backend note, hierarchy table, and rules, with no nested or buried references and no need for external bundle files — matching the short-skill guidance that well-organized sections with no external-reference needs score 5. Mentions of .squad/casting-transactions.md are runtime files the skill documents, not bundle navigation.

5 / 5

Total

17

/

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: it states concrete capabilities in third person, gives an explicit and specific load-on-demand trigger clause, and occupies a distinct niche. The only weakness is trigger-term breadth — a few natural synonyms and file-path cues are missing.

DimensionReasoningScore

Specificity

Enumerates multiple concrete capabilities comprehensively: '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'. This matches the score-5 anchor of multiple specific concrete actions with comprehensive coverage.

5 / 5

Completeness

Explicitly answers both 'what' (the complete file-by-file source-of-truth hierarchy with read/write permissions and precedence rules) 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') with concrete trigger phrases. This is the score-5 pattern; the 'when' clause is explicit and specific, so it is not the score-4 case.

5 / 5

Trigger Term Quality

Includes natural, on-domain phrases users would actually say ('resolve a write conflict', 'who owns this file', 'where does this state belong'), but misses a few natural synonyms and concrete file paths (e.g. '.squad/', 'file layout') that would broaden triggering. Fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive score-5 example.

4 / 5

Distinctiveness Conflict Risk

The niche (Squad's internal file authority hierarchy) and its triggers ('source-of-truth', 'write conflict', 'who owns this file') are domain-specific and unlikely to fire for unrelated skills. Clear niche with minimal conflict risk.

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

microsoft/waza

Path

.github/skills/coordinator-source-of-truth/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.