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.

78

1.01x
Quality

91%

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

The canonical home for this skill is self-improvement in pskoett/pskoett-ai-skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is highly actionable with complete, copy-paste-ready templates, executable commands, and well-sequenced workflows that include validation steps, checklists, and a dry-run first pass. Its weaknesses are redundancy (context-maintenance guidance repeated three times, Detection Triggers duplicating the description, generic Best Practices/Multi-Agent sections) and an orphaned references/examples.md file that is never linked from the main body.

Suggestions

Consolidate the three separate context-maintenance notes (Logging Format, Context Maintenance at Promotion, Review Actions) into a single pointer to references/context-maintenance.md near the entry template.

Link references/examples.md from the Logging Format section (e.g., 'For filled-in entry examples, see [references/examples.md]') so the 383-line examples file is discoverable from the skill body.

Trim the Detection Triggers and Best Practices sections, which restate triggers already enumerated in the description and generic advice Claude already applies, to cut roughly 20-30% of body tokens.

DimensionReasoningScore

Conciseness

The core templates are operational and lean, but there is more than minor over-explanation: the context-maintenance contract is pointed to three separate times ("Use [references/context-maintenance.md]... keep unknowns explicit", "see `references/context-maintenance.md`", "Update the existing contract using `references/context-maintenance.md`"), the Detection Triggers section largely re-enumerates triggers already in the description, and the Best Practices / Multi-Agent Support / Copilot Chat sections restate generic advice. This fits 'Mostly efficient but includes some unnecessary explanation or could be tightened' better than the 4 anchor's 'minor instances'.

3 / 5

Actionability

Guidance is copy-paste ready throughout: complete markdown entry templates with every field, executable grep commands ("grep -n "Pattern-Key: <pattern_key>" .learnings/LEARNINGS.md"), an exact ID format with examples ("LRN-20250115-001"), and a concrete extraction script invocation including a "--dry-run" first pass. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

Multi-step processes are clearly sequenced with explicit checkpoints: the extraction workflow runs a dry-run, then "Verify: Read skill in fresh session to ensure it's self-contained"; the ingestion workflow mandates search-before-create dedupe against a stable Pattern-Key; and skill edits are gated by both the Quality Gates checklist and "explicit scoped approval". This matches 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes' rather than the 4 anchor's 'minor validation gaps'.

5 / 5

Progressive Disclosure

Structure is good: setup and hooks are correctly deferred to clearly signaled references with explicit read conditions ("Read these only when installing or configuring the skill"), and all four referenced files exist and are one level deep. However, references/examples.md (383 lines of entry examples) is never linked from SKILL.md, making an entire bundle file undiscoverable — a real organization gap that keeps this at 'minor organization gaps' (4) rather than 5, though references are too clearly signaled to drop to the 3 anchor.

4 / 5

Total

17

/

20

Passed

Description

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

The description is exemplary: it states concrete capabilities, enumerates five explicit trigger conditions with quoted user phrasing, and preempts confusion with the two sibling skills via explicit redirects. Its length is justified because every clause is functional trigger or boundary guidance rather than padding.

DimensionReasoningScore

Specificity

The description names multiple concrete actions on named artifacts: "Captures learnings, errors, corrections, and feature requests", "distill into a memory file or new skill", and "review learnings before major tasks". This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' rather than the 4 anchor, which reserves room for coverage gaps — the what/when/how-promoted span of this skill is covered without omission.

5 / 5

Completeness

Both questions are explicitly answered: the what ("Captures learnings, errors, corrections, and feature requests to enable continuous improvement") and the when via a five-item "Use when:" enumeration with concrete trigger phrases. It matches the anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'; a missing/weak 'when' clause would cap it at 3, which clearly does not apply.

5 / 5

Trigger Term Quality

Trigger language includes directly quoted user utterances — "'No, that's wrong...'", "'Actually...'" — plus natural trigger conditions like "User requests a capability that doesn't exist" and "knowledge is outdated or incorrect". This is the most natural phrasing a user would actually say, matching the comprehensive-synonyms anchor rather than the 4 anchor ('a few natural terms missing').

5 / 5

Distinctiveness Conflict Risk

It has a clear niche (passive accumulation and promotion of learnings) and explicitly redirects the two adjacent skills: "For ACTIVE runtime failures... use `self-healing` instead" and "For CI-only/headless learning capture, use self-improvement-ci". This is more than the 4 anchor's 'minor overlap risk' — the main collision candidates are disambiguated inline, leaving minimal conflict risk.

5 / 5

Total

20

/

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

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