CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

feedback

Turn post-task feedback—even blunt or angry feedback—into an evidence-based, approval-gated improvement plan for the agent/user workflow. Use after agent work goes wrong, misses expectations, creates friction, or should improve in future. Never mutate during the feedback turn.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

An excellent instruction-only skill body: every section adds non-obvious, skill-specific policy, the workflow is explicitly sequenced with validation and approval gates, and details are properly delegated to real one-level-deep reference files. The only measurable weakness is minor redundancy between the intro, the non-negotiable contract, and the anti-patterns list.

Suggestions

Deduplicate the tone-handling guidance: the intro paragraph, contract item 1, and the anti-patterns list each restate the no-tone-policing rule.

Consider folding the Anti-patterns section into the contract or candidate-rejection list, since most entries restate rules already given.

DimensionReasoningScore

Conciseness

The body is dense and almost entirely skill-specific policy with no explanation of concepts Claude already knows, but there is minor redundancy — the intro paragraph ("The user does not need to calm down... Extract the useful signal without tone-policing") restates contract items 1 and 10, and the Anti-patterns section re-covers ground from the contract — matching 'efficient; minor instances... that could be trimmed' rather than 'every token earns its place'.

4 / 5

Actionability

For an instruction-only skill the guidance is fully executable: a capability-map table with fallbacks per row, an ordered six-step evidence ledger, eight named failure classes, a complete candidate schema (ID/Target/Action/Problem/Evidence/Benefit/Risk/Verification), literal approval semantics ("Approval for F1 does not authorize F2"), and a bounded thin-evidence fallback ('at most three reversible changes').

5 / 5

Workflow Clarity

Steps 0–6 are clearly sequenced with explicit checkpoints: evidence classification (Observed/Reported/Inferred/Unknown), candidate rejection criteria, a hard stop-for-approval gate, and a later-turn application loop with per-item verification and separate reporting of applied/skipped/failed/pending — satisfying the destructive-operation feedback-loop requirement ('Never claim success from a write alone; verify the result').

5 / 5

Progressive Disclosure

The body is a clear overview that routes to well-signaled, one-level-deep references — 'Read exactly one adapter before routing changes' for the five host files, plus explicit read-conditions for routing.md, approval-protocol.md, and privacy.md — and all referenced files exist in the bundle with no nested references, matching the top anchor.

5 / 5

Total

19

/

20

Passed

Description

78%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 'Use after...' trigger clause and a clearly stated, niche capability. Its main weakness is action coverage: it describes one composite action precisely rather than enumerating several concrete capabilities, and it misses a few natural trigger synonyms.

Suggestions

Enumerate the concrete sub-capabilities (e.g., diagnose failure class from evidence, route fixes to the right persistence surface, produce an approval-gated plan) instead of compressing them into one composite action.

Add common trigger synonyms such as 'complaint', 'criticism', or 'frustrated with the result' to the 'Use after...' clause.

Tighten the very broad trigger 'or should improve in future', which invites overlap with general improvement/retrospective skills.

DimensionReasoningScore

Specificity

The description names the domain and one precisely-described composite action — "Turn post-task feedback...into an evidence-based, approval-gated improvement plan" — but does not list several distinct concrete actions, matching the '1-2 concrete actions, but not comprehensive' anchor rather than the 'several specific actions' anchor above.

3 / 5

Completeness

It explicitly answers both questions: the 'what' is "Turn post-task feedback—even blunt or angry feedback—into an evidence-based, approval-gated improvement plan" and the 'when' is an explicit "Use after agent work goes wrong, misses expectations, creates friction, or should improve in future" with concrete trigger phrases, exactly matching the top anchor.

5 / 5

Trigger Term Quality

Natural phrases users would say are present ("feedback", "goes wrong", "misses expectations", "creates friction"), but common variations like "complaint", "frustrated", or "criticism" are missing, matching 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The post-task feedback-to-plan niche with approval-gating and a no-mutation constraint is mostly distinct with clear triggers, but triggers like "should improve in future" carry minor overlap risk with general retrospective or code-review improvement skills, matching 'mostly distinct; minor overlap risk' rather than the minimal-conflict 5 anchor.

4 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 5 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

davepoon/buildwithclaude

Path

plugins/all-skills/skills/feedback/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.