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.

67

Quality

84%

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 delivers strong operational content — copy-paste templates, executable grep/script commands, and quality-gate checklists — but the 480-line length works against it: it inlines templates that already exist in assets/, duplicates trigger guidance across multiple sections, and fails to link the examples reference file. Actionability is excellent; token efficiency and file structure are the weak points.

Suggestions

Replace the inlined Logging Format entry templates with pointers to the existing assets/LEARNINGS.md, assets/ERRORS.md, and assets/FEATURE_REQUESTS.md templates instead of duplicating them in the body.

Link references/examples.md from the Logging Format or Recurring Pattern Detection section so the 383-line worked-examples file is discoverable rather than orphaned.

Trim the Best Practices, Multi-Agent Support, and Detection Triggers sections, which largely restate triggers already covered by the frontmatter description and the Quick Reference table.

DimensionReasoningScore

Conciseness

The ~480-line body is mostly operational but includes sections that could be tightened or cut: "Best Practices" (8 generic bullets), "Multi-Agent Support" (restates the description's triggers), and "Detection Triggers" (repeats quoted phrases already in the frontmatter and Quick Reference). Not anchor 2 because the bulk is templates, commands, and tables rather than explanations of concepts Claude already knows.

3 / 5

Actionability

Guidance is fully executable: copy-paste entry templates, concrete commands ("mkdir -p .learnings", "grep -n \"Pattern-Key: <pattern_key>\" .learnings/LEARNINGS.md", "./skills/self-improvement/scripts/extract-skill.sh skill-name --dry-run"), a worked verbose-to-concise promotion example, and ready-made gitignore snippets. This matches the anchor-5 pattern of copy-paste-ready content covering the common cases.

5 / 5

Workflow Clarity

Multi-step flows are clearly sequenced with most checkpoints present: extraction step 5 "Verify: Read skill in fresh session", the Skill Quality Gates checklist, and the search-first dedupe step in the Simplify & Harden ingestion workflow. Not anchor 5 because the core logging and promotion workflows lack verification steps (e.g., no ID-uniqueness check against existing entries, no confirmation the promoted rule landed in the target file).

4 / 5

Progressive Disclosure

References are well signaled ("Read these only when installing or configuring the skill") and one level deep, but content that should be separate is inlined: the full entry templates in Logging Format duplicate the purpose-built assets/LEARNINGS.md, ERRORS.md, and FEATURE_REQUESTS.md files, and references/examples.md (383 lines) is never linked from the body, leaving it orphaned. Not anchor 2 because the structure, headers, and reference signaling are otherwise good.

3 / 5

Total

15

/

20

Passed

Description

92%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 explicitly answers what and when, quotes natural user trigger phrases, and actively disambiguates from the sibling self-healing and self-improvement-ci skills. The only weakness is modest trigger-term coverage — no file extensions or synonyms beyond the quoted correction phrases.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the skill's full lifecycle — "Captures learnings, errors, corrections, and feature requests", "distill into a memory file or new skill", and "review learnings before major tasks" — with concrete objects rather than abstract language. It fits the anchor-5 example's pattern of several verb+object actions with comprehensive coverage; anchor 4 (minor gaps) is too weak since capture, promotion, and review are all explicitly named.

5 / 5

Completeness

Both what ("Captures learnings, errors, corrections, and feature requests to enable continuous improvement") and when (an explicit "Use when: (1)…(5)" enumeration with concrete trigger phrases, plus "Also review learnings before major tasks") are clearly and explicitly stated. This matches the anchor-5 example structure of what + when with concrete trigger phrases; anchor 4's "when could be more explicit" does not apply.

5 / 5

Trigger Term Quality

Natural user phrases are quoted directly ("'No, that's wrong...'", "'Actually...'") alongside "knowledge is outdated or incorrect" and "a better approach is discovered", giving good keyword coverage. Not anchor 5 because it omits file extensions (e.g., ".learnings/") and common synonyms ("lessons", "user feedback") that the top anchor requires.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (passive accumulation and promotion layer) and explicitly resolves conflicts with siblings: "use `self-healing` instead" for active runtime failures and "use self-improvement-ci" for CI-only/headless capture. Trigger phrases and boundary guidance are distinct, so minimal conflict risk per anchor 5.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

pskoett/pskoett-ai-skills

Path

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