CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-self-evaluation

Use after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conciseness — with concrete evidence per criterion. Produces a structured 1-5 scorecard with specific improvement suggestions.

63

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/agent-self-evaluation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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, example-driven skill with a clear sequenced workflow and genuine validation checkpoints, held back by bundle integration issues. The missing template file and two orphaned bundle files (evaluation-criteria.md, evaluate.py) leave the progressive-disclosure layer incomplete.

Suggestions

Create `templates/evaluation-report.md` (or inline the template) — Step 3 currently directs the agent to a file that does not exist in the bundle.

Link `references/evaluation-criteria.md` from Step 2, where the agent is deciding whether a gap merits a 4 vs a 3 — that is exactly the content the file provides.

Mention `scripts/evaluate.py` in the body (e.g., a short 'Standalone use' note) so the script is discoverable without opening hook-integration.md.

DimensionReasoningScore

Conciseness

The body is mostly tight — a compact axes table, two fully worked scorecard examples, and short anti-pattern FAIL snippets, with no explanation of concepts Claude already knows. Minor trimming is possible: the Best Practices bullets ('Use tool outputs as evidence', 'If you can't find any gaps, try harder') partially restate the Evidence Rule and Step 2 guidance.

4 / 5

Actionability

Guidance is largely executable: four numbered workflow steps, a required-elements list for the report, and two complete worked scorecards in the exact output format. The gap: Step 3 points to `templates/evaluation-report.md`, which does not exist in the bundle, so the copy-paste template it promises is missing.

4 / 5

Workflow Clarity

The 4-step sequence (collect material → score each axis fresh → produce report → apply improvement) has explicit checkpoints: the Evidence Rule gates every sub-5 score, Step 4's fix-or-flag branch is a feedback loop, and the 'Would the user agree with this assessment?' self-check closes the process. Not 4: validation is explicit at each stage, not merely implied.

5 / 5

Progressive Disclosure

The body is well-sectioned and one reference (`references/hook-integration.md`) is clearly signaled, but bundle navigation is broken or incomplete: `templates/evaluation-report.md` is referenced but missing, `references/evaluation-criteria.md` (the detailed 4-vs-3 anchors Step 2 needs) exists but is never linked from SKILL.md, and `scripts/evaluate.py` is never mentioned in the body. Two unlinked bundle files plus one dead path is more than the 'minor organization gaps' of the anchor above.

3 / 5

Total

16

/

20

Passed

Description

72%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 explicitly covers what the skill does (all five axes enumerated, output format specified) and when to use it. Its weakness is trigger phrasing: the when-clause is behavioral rather than in the user's voice, and natural invocation phrases like 'rate yourself' are missing.

Suggestions

Add a natural-voice trigger to the when-clause, e.g. 'Use after completing any non-trivial task, or when the user asks to rate or evaluate the agent's output.'

Include a common synonym such as 'self-assessment' or 'rate yourself' so users phrasing the request conversationally still match.

DimensionReasoningScore

Specificity

The description names all five axes explicitly ('accuracy, completeness, clarity, actionability, conciseness') and states the concrete outputs — 'concrete evidence per criterion' and 'a structured 1-5 scorecard with specific improvement suggestions'. Multiple specific actions with comprehensive coverage of the skill's scope. Not 4: nothing within its niche is left uncovered.

5 / 5

Completeness

Both parts are answered: the 'what' is explicit ('self-rates its output on 5 axes... Produces a structured 1-5 scorecard with specific improvement suggestions') and the 'when' is an explicit 'Use after' clause. Not 5: 'any non-trivial task' is a behavioral trigger with no concrete trigger phrases — unlike an anchor-5 'when' naming the situations or user utterances that should activate the skill. Not 3: the 'when' is explicitly stated, not merely implied.

4 / 5

Trigger Term Quality

Relevant domain keywords are present (the five axis names, 'scorecard', 'self-rates its output'), but the natural phrases a user would actually say to invoke this — 'rate yourself', 'evaluate your work', 'how good was that', 'self-assess' — are absent from the description, and 'any non-trivial task' is not a phrase users say. Not 4 because common synonyms and user-voice variations are missing; not 2 because the keywords that exist are specific and on-domain rather than generic.

3 / 5

Distinctiveness Conflict Risk

The 5-axis self-rating scorecard is a clear niche distinct from review or verification skills. Not 5: 'Use after completing any non-trivial task' is a broad temporal trigger that could fire after nearly every substantive task, overlapping with any post-task verification or review skill.

4 / 5

Total

16

/

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

affaan-m/ECC

Path

skills/agent-self-evaluation/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.