CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sy-reconcile

Analyze stale or conflicting lifecycle state by separating local, PR, CI, review, tracker, artifact, and session truth. Use when status is confused, work resumed after drift, evidence lanes disagree, or a closeout claim may be stale.

Quality

84%

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.

The body is a tight, well-structured stage contract: clear when-to-use framing, a sequenced procedure with a fail-fast validation gate and explicit failure-mode routing, and a References section whose four links all resolve to real files. The skill is instruction-only (no code, appropriately), and its only weaknesses are underspecified validation commands and a verbatim duplicate of the description.

Suggestions

In the Validation section, name the exact commands to run for package-level changes (e.g., the specific plugin validation and SDK proof commands the repository wrapper provides) instead of referencing them generically.

Replace the 'When to use' section's verbatim copy of the frontmatter description with any incremental routing detail, or drop the section to save tokens.

Make 'Run the smallest relevant local check for changed files' concrete by giving an example check per changed-file type.

DimensionReasoningScore

Conciseness

The body is lean, sectioned, and free of explanations of concepts Claude already knows; every section adds stage-specific contract detail. Not a 5 because the 'When to use' section restates the frontmatter description verbatim ("Use when status is confused, work resumed after drift, evidence lanes disagree, or a closeout claim may be stale"), a duplicated line that could be trimmed; not a 3 because there is no padded or unnecessary explanation beyond that one redundancy.

4 / 5

Actionability

Concrete guidance throughout: an exact deliverable schema ("schema_version, stage, status, evidence_refs, blocked_by, and next_stage"), explicit classifications ("pass, fail, blocked, or not_checked"), and routing rules with failure modes. Not a 5 because the validation step says "run plugin validation and SDK proof commands from the repository wrapper" without naming the actual commands, leaving the executor to look them up; not a 3 because the guidance is otherwise executable and specific rather than pseudocode-level.

4 / 5

Workflow Clarity

The Procedure is a clear 5-step sequence with an explicit validation gate: "stop at the first failed required gate, classify the blocker, and do not proceed to downstream stages until the failure is resolved or explicitly waived," plus recovery routing ("a blocker with the smallest recovery step"). Not a 5 because "Run the smallest relevant local check" leaves the actual checkpoint command unspecified; not a 3 because fail-fast checkpoints and error-recovery routing are explicitly present, not implicit.

4 / 5

Progressive Disclosure

A short, well-organized body (~55 lines) with a clearly labeled References section of four one-level-deep links — "Stage contract: [contract](./references/contract.yaml)", "Eval cases", "Task profile", "Source context" — all of which exist in ./references/ with no scripts/ or assets/ directories to disclose. Content is appropriately split and navigation is trivial, matching the anchor-5 pattern; there is no inlined bulk content that should have been moved out.

5 / 5

Total

17

/

20

Passed

Description

83%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 that clearly states what the skill does and gives four explicit, natural 'Use when' triggers. The lane enumeration (local, PR, CI, review, tracker, artifact, session) makes it specific and distinctive within its domain; the only minor gaps are a missing deliverable statement and a few natural trigger synonyms.

DimensionReasoningScore

Specificity

"Analyze stale or conflicting lifecycle state by separating local, PR, CI, review, tracker, artifact, and session truth" names the domain, a concrete action (separate evidence lanes), and enumerates all seven lanes near-comprehensively. Not a 5 because it lists only one core action verb and never states the concrete deliverable (reconciliation verdict or handoff); not a 3 because the lane enumeration goes well beyond '1-2 concrete actions, not comprehensive'.

4 / 5

Completeness

Explicitly answers both: what ("Analyze stale or conflicting lifecycle state by separating local, PR, CI, review, tracker, artifact, and session truth") and when ("Use when status is confused, work resumed after drift, evidence lanes disagree, or a closeout claim may be stale") with concrete trigger phrases — a direct match for the anchor-5 example pattern. Not a 4 because the 'when' clause is already fully explicit, not something that 'could be more specific'.

5 / 5

Trigger Term Quality

"Use when status is confused, work resumed after drift, evidence lanes disagree, or a closeout claim may be stale" provides four natural trigger phrases a Harness user would plausibly say. Not a 5 because common synonyms like 'conflicting status', 'out of sync', or 'state mismatch' are missing; not a 3 because coverage is genuinely good rather than partial.

4 / 5

Distinctiveness Conflict Risk

The niche (cross-lane lifecycle state reconciliation) and distinctive triggers ("evidence lanes disagree", "closeout claim may be stale") give it a clear niche, but the generic-sounding "status is confused" and the existence of sibling routing skills (e.g., sy-reframe, which the body says handles ambiguous stage routing) create minor overlap risk with closely related skills. Not a 5 due to that intra-family overlap; not a 3 because the lane taxonomy is far more specific than 'Works with document files'.

4 / 5

Total

17

/

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

jscraik/Agent-Skills

Path

Plugins/synaipse-harness/skills/sy-reconcile/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.