CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sy-reinforce

Create a durable guardrail, validator, doc, eval, or skill-reference update from a verified failure or learning. Use when the user asks to capture learning, prevent recurrence, encode review feedback, or refresh stale guidance.

Quality

85%

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

81%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 lean, well-gated orchestration skill body with an explicit fail-fast workflow and clean one-level reference links. Its weakest point is actionability: the core step and validation commands stay abstract with no example stage-result artifact, and one bundled asset is unreferenced.

Suggestions

Make step 3 concrete by spelling out what work reinforce owns (e.g. the allowed-write surfaces from the contract: guardrail, validator, doc, eval, or reference update) instead of "Perform only the work owned by reinforce".

Include a minimal example stage-result artifact showing the declared fields and a pass/fail/blocked status, so deliverable shape is copy-paste derivable.

Link assets/resolution-template.md from the body (e.g. under Deliverables) so the bundled template is discoverable.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout (e.g. "Fail fast: stop at the first failed required gate…" and "A local artifact can explain work, but it does not prove remote PR, CI, tracker, or deployment state.") with no concept explanations or padding. The only redundancy — "When to use" restating the description verbatim — is trivial and does not break the 5 anchor's every-token-earns-its-place standard.

5 / 5

Actionability

Concrete scaffolding exists (named artifact fields "schema_version, stage, status, evidence_refs, blocked_by, next_stage" and classifications "pass, fail, blocked, or not_checked"), but key execution details are missing: "Perform only the work owned by reinforce" does not say what that work is, "run plugin validation and SDK proof commands from the repository wrapper" names commands without giving them, and no example stage-result artifact is shown. This lands between the 3 anchor (guidance present but incomplete) and 4 (mostly executable), closer to 3 since there are no commands or examples at all.

3 / 5

Workflow Clarity

The 5-step procedure is clearly sequenced 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") and a Failure modes section that gives a recovery route per error class. This matches the 5 anchor (clear sequence, explicit validation steps, error-recovery loops); a 4 would require merely-implicit checkpoints, which is not the case.

5 / 5

Progressive Disclosure

Scored against the actual bundle: all four references/ links in the body (contract.yaml, evals.yaml, task-profile.json, source-context.yaml) are real files, clearly labeled, and one level deep (e.g. "Stage contract: [contract](./references/contract.yaml)"). The gap is that assets/resolution-template.md exists in the bundle but is never referenced from SKILL.md, leaving it undiscoverable — a minor organization gap that fits the 4 anchor rather than the 5 anchor's fully easy navigation.

4 / 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 with an explicit what/when pair and mostly natural trigger phrases. The main residual risks are missing synonyms in the trigger set and mild overlap with generic documentation-update requests.

Suggestions

Broaden trigger terms with common synonyms such as 'lessons learned', 'post-mortem', or 'runbook update' to improve natural-match coverage.

Sharpen distinctiveness by naming the owning pipeline or stage context so the description cannot be confused with general doc-update or review-fix skills.

DimensionReasoningScore

Specificity

The description lists several concrete deliverables — "durable guardrail, validator, doc, eval, or skill-reference update" — from a named source ("a verified failure or learning"), with only minor coverage gaps (no indication of where or how outputs are recorded). It lists more than 1-2 actions but falls short of the comprehensive coverage of the 5 anchor.

4 / 5

Completeness

Both parts are explicit: the what ("Create a durable guardrail, validator, doc, eval, or skill-reference update from a verified failure or learning") and the when with concrete trigger phrases ("Use when the user asks to capture learning, prevent recurrence, encode review feedback, or refresh stale guidance"). This matches the 5 anchor exactly; a 4 would require a weaker or less specific when-clause, which is not the case here.

5 / 5

Trigger Term Quality

Natural phrases users would actually say — "capture learning", "prevent recurrence", "encode review feedback", "refresh stale guidance" — give good keyword coverage, but common synonyms (e.g. lessons learned, post-mortem, runbook) are missing and "skill-reference update" leans on internal harness jargon. Better than the 3 anchor's partial keyword set, short of the 5 anchor's synonym-level comprehensiveness.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct (durable learning capture from verified failures), but triggers like "refresh stale guidance" and "encode review feedback" carry minor overlap risk with general doc-update or review-fix skills, and sibling pipeline stages share vocabulary. This fits the 4 anchor (minor overlap with closely related skills) better than the 5 anchor (minimal conflict risk).

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-reinforce/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.