CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

best-practices-learner

Extract learnings and best practices from skill development experience, review findings, and pattern analysis. Task-based operations for pattern extraction, learning documentation, guideline updates, knowledge sharing, and continuous improvement. Use when extracting learnings from completed skills, updating best practices, improving development process, or feeding continuous improvement cycle.

Quality

72%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/best-practices-learner/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

48%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 well-structured with clear per-operation workflows and validation checkpoints, but it is a monolithic, heavily padded document: repetitive process bullets, very long inlined examples with time-sensitive data, and no reference files or concrete file-level mechanics. It would benefit substantially from splitting examples into references and tightening the process prose.

Suggestions

Move the long worked examples (Pattern Extracted, Learning Documented, Guideline Update, Evolution Tracker, Knowledge Sharing blocks) into a references/ file such as references/examples.md, keeping one-line pointers in SKILL.md — this addresses both the conciseness and progressive_disclosure gaps.

Trim the 'When to Use' bullet lists and process sub-bullets that restate obvious questions ('What worked well?', 'Why did Y fail?'), keeping only the numbered steps, validation checkpoints, and category definitions.

Add concrete mechanics for the guideline updates: actual file paths for common-patterns.md, development-workflow, and templates, plus the exact procedure for applying and validating an update, so the guidance is executable rather than descriptive.

DimensionReasoningScore

Conciseness

The body is noticeably verbose: five near-identical operation sections padded with obvious sub-bullet questions ('What worked well in this skill?', 'Why did X work well?'), plus 30-50-line worked examples containing time-sensitive fabricated metrics ('Updated 2025-11-07', '159 hours (72% reduction)') that are not in a deprecated/old-patterns section. It avoids anchor 1 because it does not explain external concepts Claude already knows, but several sections are padded and could be cut by more than half.

2 / 5

Actionability

The worked examples (Pattern Extracted, Learning Documented, Guideline Update, Evolution Tracker) provide concrete output formats, but key execution details are missing — no file paths or edit procedures for common-patterns.md, development-workflow, or templates, and no commands. This matches anchor 3's 'some concrete guidance but incomplete; missing key details' rather than anchor 4's 'minor gaps'.

3 / 5

Workflow Clarity

Each of the five operations has a clear numbered 5-step sequence with explicit validation checkpoints ('Validate Pattern: Is this truly a pattern... 2+ instances?', 'Validate Updates: Are updates clear and actionable?'). It falls short of anchor 5 because there are no error-recovery feedback loops (no 'if validation fails, do X') and no overall checklist tying the operations together; it exceeds anchor 3 because checkpoints are explicit rather than implicit.

4 / 5

Progressive Disclosure

The single ~480-line SKILL.md has good section structure and a Quick Reference table, but the long worked examples and per-operation detail clearly belong in separate reference files and no references/ directory exists. This sits between anchor 2's 'minimal structure with inlined content' (structure is actually well-organized) and anchor 4's 'content appropriately placed' (nothing is split out), so anchor 3's 'content that should be separate is inline' is the best fit.

3 / 5

Total

12

/

20

Passed

Description

83%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: it explicitly states what the skill does and when to use it, with concrete operation names and natural trigger phrases. The only weaknesses are the vague 'continuous improvement' phrasing, missing synonyms like 'lessons learned' or 'retrospective', and slight trigger overlap with analysis/review skills.

DimensionReasoningScore

Specificity

Lists several specific operations — 'pattern extraction, learning documentation, guideline updates, knowledge sharing' — with only minor vagueness ('continuous improvement', 'task-based operations'). It falls short of anchor 5 because the actions are noun-phrase abstractions rather than fully comprehensive concrete verbs, but exceeds anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

Explicitly answers both questions: the 'what' is stated twice ('Extract learnings and best practices from skill development experience...' and the operations list), and an explicit 'Use when extracting learnings from completed skills, updating best practices, improving development process, or feeding continuous improvement cycle' clause gives four concrete triggers. This matches anchor 5 exactly; anchor 4's 'when could be more explicit' does not apply since the when-clause is specific.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'extracting learnings', 'updating best practices', 'completed skills', 'skill development experience', 'review findings'. A few natural terms are missing — no synonyms like 'lessons learned', 'retrospective', or 'post-build review' — so it does not reach anchor 5's comprehensive coverage, but it clearly exceeds anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

The learning-capture niche is mostly distinct with triggers tied to skill development and reviews, but 'review findings' and 'pattern analysis' create minor overlap risk with sibling analysis/review skills in the same ecosystem. Anchor 5's 'minimal conflict risk' is not fully met, while anchor 3's broad overlap understates the niche focus.

4 / 5

Total

17

/

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

fernandezbaptiste/Skrillz

Path

skills/best-practices-learner/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.