CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

done-gate-report

Write status and completion reports that can never overstate what is done — limits first, every completion line tied to an item ID and its exact verifier verdict, copied numbers, named environments — and self-check them with the allow-list auditor before sending. Use for every final answer, status update, PR description, or handoff that reports work.

72

Quality

90%

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

88%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 tight, rule-dense body with an exact report template, fixed verdict vocabulary, a real validation feedback loop, and explicit exit criteria — exemplary conciseness and workflow clarity for a simple gating skill. Its one real weakness is the dependency on tools/claim_audit.py and ledger_facts.json, which are referenced by exact path but not bundled or described, leaving the self-check unresolvable from the skill alone.

Suggestions

Bundle the auditor (e.g. scripts/claim_audit.py) and reference it with a skill-relative path, or state where it comes from, so the "Self-check before sending" command is actually runnable from the skill's contents.

Briefly define the verifier ledger and the expected format of ledger_facts.json (even one line, e.g. where the ledger is produced and its minimal schema), since the allow-list and verdict vocabulary all depend on it.

DimensionReasoningScore

Conciseness

The ~30-line body is lean and assumes Claude's competence: a compact template for the status section, a five-item allow-list, a four-item never-list, one exact self-check command, and two-line exit criteria. Every line adds a rule Claude could not infer, with no padding or explanation of known concepts — matching the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

Guidance is concrete: an exact status-section shape with placeholder syntax, a fixed verdict vocabulary (VERIFIED | NOT VERIFIED | NOT FIXED | PARTIALLY FIXED | IMPLEMENTED | PROPOSED), and the copy-paste command "python3 tools/claim_audit.py --report report.md --facts ledger_facts.json". It falls short of fully executable because that auditor script and the ledger_facts.json format are not bundled with the skill (no references/, scripts/, or assets/ exist), leaving the core self-check mechanism unrunnable from the skill alone — a concrete command with a real gap rather than a minor one.

4 / 5

Workflow Clarity

The workflow is unambiguous for this simple single-purpose skill: construct the report to the required shape using only allowed statements, run the auditor, and "If it flags a line, rewrite the line from the ledger; do not argue with the checker" — an explicit validate→fix→retry feedback loop — with exit criteria of "required shape and zero auditor flags". The validation step, error-recovery loop, and completion checklist match the top anchor.

5 / 5

Progressive Disclosure

For an under-50-line skill with well-organized sections (Required shape, Allowed, Never, Self-check, Exit criteria) a 5 is available, but the body references external files — tools/claim_audit.py and ledger_facts.json — that are not present in the bundle (no references/, scripts/, or assets/ directories exist), so the reference is dangling and a reader cannot navigate to the auditor's definition. That is 'good structure with minor organization gaps' rather than fully clear navigation.

4 / 5

Total

18

/

20

Passed

Description

88%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 the skill's mechanics concretely (limits first, ID-tied verdicts, copied numbers, named environments, auditor self-check) and gives an explicit, multi-situation 'Use for…' trigger clause in third person. Its only weaknesses are a few missing natural synonyms in the trigger terms and a broad 'every final answer' trigger that slightly raises overlap risk.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — "Write status and completion reports", "limits first, every completion line tied to an item ID and its exact verifier verdict, copied numbers, named environments", and "self-check them with the allow-list auditor" — giving comprehensive, explicit coverage of what the skill does. It clearly matches the anchor for multiple specific concrete actions rather than the anchor 4 example, which would leave minor gaps in coverage.

5 / 5

Completeness

It explicitly answers both what ("Write status and completion reports that can never overstate what is done … self-check them with the allow-list auditor before sending") and when ("Use for every final answer, status update, PR description, or handoff that reports work") with concrete trigger phrases. Not the level below (4) because the 'when' clause is explicit and enumerates concrete triggering situations rather than being merely serviceable.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: "status update", "PR description", "handoff", "final answer", "completion reports". A few natural synonyms and variations are missing (e.g. "progress report", "wrap-up", "work summary"), which fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The niche — honesty-gated completion reporting with an auditor self-check — is distinct, and triggers like "handoff" and "PR description" are specific to it. However, the very broad trigger "every final answer … that reports work" gives minor overlap risk with general reporting/communication skills, so it sits at 'mostly distinct' rather than a clear niche with minimal conflict risk.

4 / 5

Total

18

/

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

itsablabla/qa-bug-agent-skills

Path

skills/done-gate-report/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.