CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

64

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No known issues

Fix and improve this skill with Tessl

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

Quality

Content

77%

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 well-organized, actionable skill with a clear sequenced workflow, feedback loop, and worked examples. Its weaknesses are moderate verbosity (some framing and restated rules could be trimmed) and progressive-disclosure gaps: a broken template reference and two bundle files that are never linked from the body.

Suggestions

Fix the broken reference: either create templates/evaluation-report.md or change 'Use the template from templates/evaluation-report.md' to point to the actual file (or keep the inline template and drop the pointer).

Link the unreferenced bundle files from the body — e.g., mention references/evaluation-criteria.md near the scoring section and scripts/evaluate.py near the workflow — so the existing materials are discoverable.

Trim redundant framing: condense the intro paragraph and de-duplicate the evidence rule (stated in Core Concepts, Best Practices, and shown in examples) to tighten token use.

DimensionReasoningScore

Conciseness

The body is substantive and avoids explaining concepts Claude already knows, but it is long (~180 lines) with some tightening available — the intro framing ('This is NOT a pass/fail gate — it's a deliberate reflection step that catches omissions, flags overconfidence...') is padded, and the evidence rule is restated across Core Concepts, Best Practices, and the examples. This fits 'mostly efficient but could be tightened'; it is not score 3 because not every token earns its place, and not score 1 because there is no basic-concept filler.

2 / 3

Actionability

Provides concrete executable guidance: a 5-axis table with per-axis questions, a 4-step workflow with substeps, an inline report template structure, and two fully-worked good/weak scorecard examples that are copy-paste-ready models — matching the score-3 anchor of specific examples for an instruction skill. It is not score 2 because guidance is complete and concrete rather than pseudocode or missing key details (the inline template compensates for the broken file reference, which is scored under progressive_disclosure).

3 / 3

Workflow Clarity

The Workflow is a clear 4-step sequence (Collect → Score each axis → Produce report → Apply improvement) with a real feedback loop in Step 4 ('if fixable in <30 seconds, fix now; if rework needed, flag it') and a self-check checkpoint ('Would the user agree with this assessment?'), matching the score-3 anchor of explicit validation/feedback steps. This is a meta-cognitive skill, not a destructive/batch operation, so the strict feedback-loop cap does not apply; it is not score 2 because checkpoints are explicit rather than implicit.

3 / 3

Progressive Disclosure

The body is well-sectioned and references hook-integration.md (a real one-level-deep file), but it points to templates/evaluation-report.md which does not exist (a navigation dead-end) and never references the two other bundle files present (references/evaluation-criteria.md, scripts/evaluate.py), fitting 'some structure but references not clearly signaled'. It is not score 3 because of the broken path and unreferenced bundle files, and not score 1 because references are one level deep with no nesting.

2 / 3

Total

10

/

12

Passed

Description

77%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description clearly states both what the skill does and when to use it, with concrete enumerated actions. Its main weakness is trigger-term naturalness — the phrases a user would actually say to invoke it live in the body, not the description — and a somewhat broad activation trigger that risks overlap with sibling review skills.

Suggestions

Add natural user-facing trigger phrases to the description itself (e.g., 'Use when the user asks you to rate yourself, evaluate your work, or asks "how good was that?"') so the description alone surfaces the skill.

Tighten the activation trigger from 'any non-trivial task' to a more distinctive condition (e.g., 'after delivering code, a design doc, or a multi-step workflow') to reduce overlap with agent-eval and verification-loop.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'self-rates its output on 5 axes', 'concrete evidence per criterion', 'Produces a structured 1-5 scorecard with specific improvement suggestions' — matching the score-3 anchor of multiple specific concrete actions; it is not score 2 because the actions are enumerated and comprehensive rather than partial. The imperative 'Use after completing' mirrors the accepted 'Use when...' form in the good examples, so no second-person penalty applies.

3 / 3

Completeness

Explicitly answers both: WHAT ('self-rates its output on 5 axes... Produces a structured 1-5 scorecard') and WHEN ('Use after completing any non-trivial task'), matching the score-3 anchor with an explicit trigger clause. The 'Use after completing...' clause is an explicit trigger, so it is not capped at 2 per the missing-trigger guideline.

3 / 3

Trigger Term Quality

The trigger 'Use after completing any non-trivial task' gives an activation context, but the description lacks the natural user-facing phrases ('rate yourself', 'how good was that', 'evaluate your work') that appear only in the body, so it has some relevant keywords but misses common variations. It is not score 3 because users would not naturally utter 'self-rates its output on 5 axes' to invoke the skill, and not score 1 because 'non-trivial task' and 'scorecard' are recognizable.

2 / 3

Distinctiveness Conflict Risk

The function (5-axis self-rating scorecard) is a fairly distinct niche, but the trigger 'after completing any non-trivial task' is broad enough to overlap with related review/verification skills (agent-eval, verification-loop are named in the body), fitting 'somewhat specific but could still overlap'. It is not score 3 because the activation condition is generic, and not score 1 because the scorecard function is clearly bounded.

2 / 3

Total

10

/

12

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.

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