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

71%

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

The canonical home for this skill is best-practices-learner in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

56%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, embedded validation checkpoints, and genuinely useful worked-example templates, but it is badly over-tokenized: generic question-lists, a triple-repetition of the same material (operations, best practices, quick reference), and 480 lines that should be a lean overview plus reference files. The main fixes are aggressive trimming of self-evident scaffolding and moving worked examples to bundled references.

Suggestions

Cut the generic question-style bullets from every Process section (e.g., 'What worked well in this skill?', 'Why did X work well?') — Claude can generate these prompts itself; keep only the steps and criteria that are ecosystem-specific (e.g., the '2+ instances' pattern-validation threshold).

Move the long worked examples (Pattern Extracted, Learning Documented, Guideline Update, Evolution Tracker, Knowledge Sharing) into a references/ file (e.g., references/example-outputs.md) and keep one condensed example inline, cutting the body by well over half.

Eliminate the triple redundancy between the Operations sections, the Best Practices section, and the Quick Reference table — fold the Best Practices items into their corresponding operations and keep only the summary table at the end.

DimensionReasoningScore

Conciseness

The ~480-line body is noticeably verbose with several padded sections: every operation repeats a Purpose/When to Use/Process/Example scaffold whose process steps are generic self-evident questions ('What worked well in this skill?', 'Why did X work well?'), and the Best Practices and Quick Reference sections restate the operations a third time. It is not a 1 because the worked examples do convey genuine, non-obvious output formats and evidence rather than explaining concepts Claude already knows.

2 / 5

Actionability

Each operation includes a full worked example ('Pattern Extracted: Quick Reference Section', 'Learning Documented: High-Quality Prompts Save Implementation Time', 'Evolution Tracker') that serves as a copy-adaptable output template, and the Quick Reference table gives concrete when/outputs per operation. As an instruction-only skill this is mostly executable guidance; the gap to 5 is that the process steps themselves remain abstract question-lists rather than concrete procedures.

4 / 5

Workflow Clarity

Each operation has a clearly numbered 5-step sequence, and validation checkpoints appear where they matter: 'Validate Pattern' (recurring? 2+ instances? generalizable?) in Operation 1 and 'Validate Updates' in Operation 3, plus the explicit continuous-improvement loop in the Overview. It falls short of 5 because some checkpoints are soft question-lists rather than explicit pass/fail gates, and Operations 2, 4, and 5 have no validation step at all.

4 / 5

Progressive Disclosure

The body has good section structure (Overview, When to Use, per-operation sections, Quick Reference), but it is a single monolithic ~480-line file with no references/ or assets/ bundle: the 20-40 line worked examples and the per-operation process details are exactly the content that should be split into one-level-deep reference files. This matches the 'some structure, but content that should be separate is inline' anchor rather than the 2, since sections and navigation are clear.

3 / 5

Total

13

/

20

Passed

Description

75%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 solid description that clearly answers both what the skill does and when to use it, with domain-specific action verbs and reasonable trigger phrases. Main weaknesses are the buzzwordy 'Task-based operations for...' filler and a when-clause that is circular (restating the operations) rather than situational, plus a few missing natural synonyms like 'lessons learned'.

DimensionReasoningScore

Specificity

The description lists several specific actions within its domain — 'pattern extraction, learning documentation, guideline updates, knowledge sharing' plus 'Extract learnings and best practices from skill development experience, review findings, and pattern analysis' — with only minor coverage gaps. It falls short of a 5 because 'Task-based operations for... and continuous improvement' is filler/abstract phrasing rather than a concrete action, keeping it from comprehensive concrete coverage.

4 / 5

Completeness

Both 'what' (extract learnings/patterns from skill development experience, review findings, pattern analysis) and 'when' (explicit 'Use when extracting learnings from completed skills, updating best practices, improving development process, or feeding continuous improvement cycle') are present. It is not a 5 because the when-clause largely restates the operations rather than naming situational triggers (e.g., 'after completing a skill build or review'), making it circular rather than fully concrete.

4 / 5

Trigger Term Quality

The 'Use when' clause supplies good natural keywords a user in this ecosystem would say: 'extracting learnings from completed skills', 'updating best practices', 'improving development process'. A few common synonyms are missing ('lessons learned', 'retrospective', 'capture learnings'), which keeps it below the comprehensive-synonym anchor of 5.

4 / 5

Distinctiveness Conflict Risk

The niche — extracting learnings from skill development experience and feeding them into guidelines — is mostly distinct with clear triggers. Minor overlap risk remains with closely related meta-skills (skill review/analysis, documentation skills) that could also claim 'review findings' and 'pattern analysis'.

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

fernandezbaptiste/Skrillz

Path

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