CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

self-improvement

Captures learnings, errors, corrections, and feature requests to enable continuous improvement. Use when: (1) User corrects Claude ('No, that's wrong...', 'Actually...'), (2) User requests a capability that doesn't exist, (3) Claude realizes its knowledge is outdated or incorrect, (4) A better approach is discovered for a recurring task, (5) Receiving a Handoff block from self-healing (a recurring verified heal with Recurrence-Count at least 3) to distill into a memory file or new skill. For ACTIVE runtime failures where the agent needs to apply and verify a fix mid-task, use `self-healing` instead (it files HEAL- entries with proof; self-improvement promotes accumulated patterns). Also review learnings before major tasks. For CI-only/headless learning capture, use self-improvement-ci.

72

1.01x
Quality

84%

Does it follow best practices?

Impact

98%

1.01x

1 of 3 eval scenarios. Add 2 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 highly actionable body — copy-paste templates, exact commands, and explicit thresholds make the skill trivially executable — with well-signaled one-level-deep references that all resolve to real files. The main weakness is length: some sections duplicate each other and a bundle reference goes unlinked, which costs token efficiency and navigability.

Suggestions

Trim or merge the 'Multi-Agent Support' section into 'Detection Triggers' and drop or compress 'Copilot Chat Integration' — both largely restate triggers already covered and pad the token budget without new guidance.

Link references/examples.md from the body (e.g., from 'Logging Format' or 'Promotion Examples') so the existing worked examples are discoverable instead of orphaned in the bundle.

Move the dense capture-time Context Maintenance field block (Decay-Type/Authority/Revalidation/Disposition) into references/context-maintenance.md and keep only a one-line pointer in the entry template, reserving the body for the promoted-time contract.

DimensionReasoningScore

Conciseness

Mostly efficient — entry templates, ID formats, and promotion rules are project-specific and earn their tokens — but there is noticeable padding that could be trimmed: the "Multi-Agent Support" list rephrases the "Detection Triggers" section, the "Copilot Chat Integration" section is thin filler, and the capture-time Context Maintenance field block is dense/cryptic. Not a 2 because the bulk is non-obvious, skill-specific content rather than explanations of things Claude already knows.

3 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: complete markdown entry templates for all three entry types, exact ID format with examples, concrete grep commands ("grep -n \"Pattern-Key: <pattern_key>\" .learnings/LEARNINGS.md"), runnable script invocations with --dry-run, and worked before/after promotion examples. Not below 5 since the common cases are covered with specific, complete artifacts.

5 / 5

Workflow Clarity

Multi-step processes are clearly sequenced with numbered steps and explicit criteria (promotion rule with three conditions, search-first dedupe, quality-gates checklist, and a verify step "Read skill in fresh session to ensure it's self-contained"). Not a 5 because several workflows (resolving entries, promoting to CLAUDE.md) lack explicit post-action validation checkpoints; no destructive/batch cap applies since operations are append/update markdown.

4 / 5

Progressive Disclosure

Good structure against the actual bundle: body sections point to real one-level-deep references ([references/installation.md], [references/hooks-setup.md], [references/amp-setup.md], [references/context-maintenance.md]) with clear "read only when" signaling, plus assets and scripts. Not a 5 because references/examples.md exists in the bundle but is never linked from the body, and secondary sections (Multi-Agent Support, Gitignore Options, Copilot Chat) could be externalized to shorten the ~485-line overview.

4 / 5

Total

16

/

20

Passed

Description

87%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 clearly states what the skill does, gives five explicit numbered trigger conditions with natural quoted phrases, and actively disambiguates against the adjacent self-healing and self-improvement-ci skills. Slight room to trade internal jargon for more everyday user phrasing.

DimensionReasoningScore

Specificity

Lists several concrete actions — "Captures learnings, errors, corrections, and feature requests", "distill into a memory file or new skill", "review learnings before major tasks" — with only minor gaps (specific capture targets like `.learnings/` files and promotion destinations are not named). Not a 5 because the action list is slightly less comprehensive than the anchor's fully enumerated coverage; not a 3 because it goes well beyond naming 1-2 actions.

4 / 5

Completeness

Explicitly answers both: what ("Captures learnings, errors, corrections, and feature requests to enable continuous improvement") and when (five numbered trigger conditions with concrete quoted phrases). Matches the anchor's pattern of clear what + explicit 'Use when' with concrete trigger phrases; a missing 'Use when' would cap it at 3, but it is fully present.

5 / 5

Trigger Term Quality

Good natural-term coverage including quoted phrases users actually say ("No, that's wrong...", "Actually...", user requests a capability that doesn't exist, outdated knowledge, better approach). Not a 5 because common variations like "save this", "remember this", or "learn from this" are absent while space is spent on internal jargon like "Handoff block" and "Recurrence-Count".

4 / 5

Distinctiveness Conflict Risk

Clear niche (passive accumulation/promotion vs active runtime repair) with explicit boundary redirects: "For ACTIVE runtime failures... use `self-healing` instead" and "For CI-only/headless learning capture, use self-improvement-ci". Minimal conflict risk since the disambiguation is built into the description itself.

5 / 5

Total

18

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

pskoett/pskoett-ai-skills

Path

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