CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

learn-and-improve

This skill should be used when the user asks to "improve my setup", "learn from this session", "fix my config", "stop asking for permissions", or reports friction with skills, agents, hooks, or permissions. Analyzes conversation history and proposes configuration improvements.

68

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

86%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-engineered instruction skill: concrete paths, tables, and templates make it immediately actionable, with detail correctly offloaded to three real one-level-deep references. The only gaps are a missing validation-failure retry loop and small redundant tail sections.

DimensionReasoningScore

Conciseness

The body is dominated by terse tables, exact file paths, and directives that assume Claude's competence — no basic-concept padding. Minor trimmable parts exist: the Quick Reference section re-links improvement-types.md already cited in Steps 3-4, and the trailing external Vercel blog citation adds tokens without operational value. Anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') fits; not 5 because of that redundant tail.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: exact diagnostic file paths, a 9-row symptom-to-cause-to-fix-location table, a copy-paste markdown template for the verified-improvements log, and a concrete What/Why/Who/Risk presentation format covering the common cases. Per the rubric's scoring notes, absence of code is not penalized when guidance is this actionable.

5 / 5

Workflow Clarity

Six clearly sequenced steps with real checkpoints: confirm understanding via AskUserQuestion, confirm-before-writing constraint, post-write validation ('Verify the file is valid JSON... or valid markdown'), and a user-confirmation feedback loop in Step 6. It falls short of anchor 5 only because there is no explicit fix-and-retry loop if the Step 5 validation fails.

4 / 5

Progressive Disclosure

The body is a well-organized overview and all three referenced files (improvement-types.md, verified-improvements.md, diagnostic-checklist.md) exist, are one level deep, clearly signaled with descriptive link context, and carry the detail weight. This matches anchor 5 ('clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation').

5 / 5

Total

18

/

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-when clause full of natural trigger phrases and a clear third-person capability statement. Its only weaknesses are limited enumeration of concrete actions and a few missing trigger synonyms.

DimensionReasoningScore

Specificity

The description states the domain ('configuration improvements') with two concrete actions ('Analyzes conversation history and proposes configuration improvements') but stops there — it does not enumerate the concrete levers like settings.json, CLAUDE.md, hooks, or permissions rules. Anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') is the closest match; anchor 4 requires several specific actions.

3 / 5

Completeness

Both halves are explicit: 'Analyzes conversation history and proposes configuration improvements' answers what, and 'This skill should be used when the user asks to...' provides concrete trigger phrases answering when. This matches anchor 5's structure almost exactly.

5 / 5

Trigger Term Quality

Natural quoted phrases users would actually say are present ('improve my setup', 'learn from this session', 'fix my config', 'stop asking for permissions') plus category triggers ('reports friction with skills, agents, hooks, or permissions'). A few natural variants are missing (e.g., 'tune my settings', 'remember this', 'update my rules'), so it fits anchor 4 rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The Claude Code configuration-improvement niche is distinct with specific quoted triggers, but 'fix my config' could minorly overlap with general configuration or memory/rules skills. Anchor 4 ('mostly distinct; minor overlap risk with closely related skills') fits better than 5.

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

dwmkerr/claude-toolkit

Path

plugins/toolkit/skills/learn-and-improve/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.