CtrlK
BlogDocsLog inGet started
Tessl Logo

learnings-researcher

Searches docs/solutions/ for relevant past solutions by frontmatter metadata. Use before implementing features or fixing problems to surface institutional knowledge and prevent repeated mistakes.

60

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 ./.agents/skills/learnings-researcher/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 well-engineered search workflow with concrete patterns, thresholds, and genuine feedback loops for candidate narrowing. The weaknesses are redundancy between the step instructions and the DO/DON'T recap, and the schema reference material being inlined in SKILL.md while the pointer to the external schema file is broken.

Suggestions

Move the full Frontmatter Schema Reference (enum value lists and category directory map) into a bundled references file (e.g., references/yaml-schema.md) and replace the inline block with a one-line link — the current pointer to ../../skills/ce-compound/references/yaml-schema.md does not resolve from this skill's location.

Cut the Efficiency Guidelines DO/DON'T lists down to only the rules not already stated in Steps 1-6 (roughly the parallel-search and title: reminders), saving a substantial block of tokens.

Translate the notional "content-search: pattern=..." invocations into the concrete tool syntax of the target environment (e.g., actual Grep invocations with flags) so the examples are executable as written.

DimensionReasoningScore

Conciseness

The body is mostly efficient and assumes competence, but the 'Efficiency Guidelines' DO/DON'T lists restate rules already given in Steps 1-6 (pre-filter before reading, parallel searches, always read critical-patterns.md, narrow if >25 candidates), and asides like "Why this works: Content search scans file contents without reading into context" explain things Claude already knows. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the lean score-5 anchor; it is not padded enough for a 2.

3 / 5

Actionability

Guidance is highly concrete — copy-adaptable regex patterns ("title:.*email", "tags:.*(payment|billing|stripe|subscription)"), a category-to-directory table, a read-limit recipe ("Read: [file_path] with limit:30"), and fully specified output templates. It stops short of a 5 because the tool invocations use a notional "content-search: pattern=..." syntax rather than a real, executable tool-call format, leaving minor gaps in exactness.

4 / 5

Workflow Clarity

The seven-step sequence is explicit with built-in feedback loops: if search returns >25 candidates, re-narrow with more specific patterns or category narrowing; if <3, fall back to a broader search; Step 3b is an unconditional checkpoint (always read critical-patterns.md); and a 'No Matches' branch is defined in the output format. This matches the anchor for a clear sequence with explicit checkpoints and error-recovery loops, and the workflow is read-only so no destructive-operation cap applies.

5 / 5

Progressive Disclosure

The one explicit reference — "Use this on-demand schema reference ... ../../skills/ce-compound/references/yaml-schema.md" — points outside the bundle and does not resolve to any real file (verified), and the ~45-line Frontmatter Schema Reference (enum lists, category directory map) is exactly the kind of lookup content that belongs in that separate reference file but is inlined instead. The surrounding section structure is good, so this sits at 'some structure, references present but not clearly signaled/broken, content that should be separate is inline' rather than the minimal-structure anchor of 2 or the well-placed anchor of 4.

3 / 5

Total

15

/

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 strong description with an explicit, well-structured 'what + when' pair and a distinct niche. Its main weakness is keyword breadth — it relies on a single trigger clause and omits natural variations like 'bug', 'debugging', or 'past learnings' that a user might say when needing this skill.

DimensionReasoningScore

Specificity

The description names the domain ("docs/solutions/" knowledge base) and one concrete action — "Searches ... for relevant past solutions by frontmatter metadata" — but offers only that single mechanism, matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. It does not list several specific actions (e.g., scoring, ranking, distilling) that would reach the score-4 anchor.

3 / 5

Completeness

Both questions are explicitly answered with concrete trigger phrasing: what — "Searches docs/solutions/ for relevant past solutions by frontmatter metadata"; when — "Use before implementing features or fixing problems to surface institutional knowledge and prevent repeated mistakes." This mirrors the score-5 example structure (action sentence plus explicit 'Use when/before...' clause), and neither half is vague.

5 / 5

Trigger Term Quality

"implementing features or fixing problems" are reasonably natural user phrases, but the description misses common variations users would say — "bug", "debugging", "learnings", "past mistakes", "institutional knowledge" is stated as purpose rather than as a trigger synonym. This fits 'some relevant keywords but missing common variations or synonyms' rather than the good-coverage anchor of 4.

3 / 5

Distinctiveness Conflict Risk

The trigger is tightly scoped to a specific, unusual artifact (a docs/solutions/ directory searched by YAML frontmatter metadata) before feature work or bug fixes — a clear niche with distinct triggers and minimal overlap risk with general search, documentation, or planning skills.

5 / 5

Total

16

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository
udecode/plate
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.