CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

learning-aggregator

[Beta] Cross-session analysis of accumulated .learnings/ files. Reads all entries, groups by pattern_key, computes recurrence across sessions, and outputs ranked promotion candidates. This is the outer loop's inspect step — it turns raw learning data into actionable gap reports. Use on a regular cadence (weekly, before major tasks, or at session start for critical projects). Can be invoked manually or scheduled.

Quality

82%

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 learning-aggregator in pskoett/pskoett-ai-skills

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 an exceptionally actionable, well-sequenced analysis workflow with concrete thresholds, commands, and a complete output template, plus strong validation and fallback handling. Its weaknesses are length that could be tightened and a monolithic structure that inlines the entire deep-mode trace-analysis section rather than splitting it into a reference file.

Suggestions

Move the Session Trace Analysis section (Entire CLI usage, extraction rules, merge format) into a references/ file (e.g. TRACE-ANALYSIS.md), keeping only a short '--deep mode: see [TRACE-ANALYSIS.md]' pointer in SKILL.md.

Trim the 'Why both sources matter' rationale and trace-pattern examples to a few lines each; the operational rules already carry the point.

Drop or de-emphasize the 'Entire (v0.5.4+)' version pin, which will go stale, or move it into the trace-analysis reference.

DimensionReasoningScore

Conciseness

The body is mostly dense, operational instruction with little generic-concept padding, but it includes rationale sections ('Why both sources matter', the trace-pattern examples, the YAML merge sample), a partially redundant 'What This Skill Does NOT Do' list, and a version pin ('Entire (v0.5.4+)'). It 'could be tightened' in several places, matching the level-3 anchor rather than level 4's 'minor instances of over-explanation'.

3 / 5

Actionability

Guidance is fully concrete and executable for an instruction-only skill: exact thresholds ('Recurrence-Count >= 3', '>= 2 distinct tasks', '30-day window', '90 days' staleness), exact CLI commands ('entire rewind --list', 'entire explain --checkpoint <id> --full --no-pager'), complete field vocabularies, and a copy-ready gap-report output template. This matches the level-5 anchor's 'specific examples cover the common cases'.

5 / 5

Workflow Clarity

Steps 1–5 are explicitly sequenced with validation logic (canonical-occurrence dedup rules, 'corroborate with the recorded tool status', terminal-status/regression handling) and error-recovery fallbacks ('If entire is not installed... falls back to .learnings/-only mode and reports the exact limitation'). The skill is read-only analysis, so the destructive/batch validation cap does not apply, and the fallback-plus-corroboration behavior satisfies the level-5 anchor.

5 / 5

Progressive Disclosure

The single ~310-line SKILL.md has good section headers, but no bundle files exist (no references/, scripts/, or assets/), roughly 120 lines of --deep/Entire trace-analysis detail that belongs in a reference file are inlined, and the mentioned 'scripts/' location does not exist. This matches 'content that should be separate is inline' at level 3 rather than level 4's 'most content is appropriately placed'.

3 / 5

Total

16

/

20

Passed

Description

80%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 clearly and explicitly states both what the skill does and when to use it, with concrete actions and a distinct niche. Its main weakness is trigger-term phrasing that over-relies on internal system vocabulary ('outer loop', 'pattern_key', 'inspect step') rather than the natural language a user would say when they need this skill.

Suggestions

Add natural user-side trigger phrases, e.g. 'Use when the user asks to review or aggregate learnings, find recurring patterns across sessions, or generate a gap report.'

Trim internal jargon from the trigger portion ('outer loop''s inspect step') or pair it with plain-language equivalents so the description matches how users would actually phrase the request.

Consider mentioning the --deep session-trace analysis mode briefly so the description covers the skill's full capability surface.

DimensionReasoningScore

Specificity

The description lists several concrete actions ('Reads all entries, groups by pattern_key, computes recurrence across sessions, and outputs ranked promotion candidates') plus a concrete output artifact ('actionable gap reports'). It stops short of comprehensive coverage — e.g., the --deep trace-analysis capability is never hinted at — matching 'several specific actions; minor gaps in coverage' rather than the level-5 anchor.

4 / 5

Completeness

It explicitly answers both 'what' (reads, groups, computes recurrence, outputs ranked promotion candidates / gap reports) and 'when' ('Use on a regular cadence (weekly, before major tasks, or at session start for critical projects). Can be invoked manually or scheduled.'). The explicit 'Use on...' clause with concrete trigger phrases matches the level-5 anchor; level 4 would require the 'when' to be less specific than it is here.

5 / 5

Trigger Term Quality

Relevant keywords are present ('.learnings/', 'gap reports', 'recurrence', 'promotion candidates') but the phrasing leans on system-internal jargon ('the outer loop''s inspect step', 'pattern_key') and omits natural user variations like 'review my learnings' or 'recurring patterns'. This matches 'some relevant keywords but missing common variations or synonyms'; it is not level 4 because natural-term coverage is not good enough to be only 'a few missing'.

3 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — cross-session analysis of accumulated '.learnings/' files — with trigger terms that no other plausible skill would fire on. Minimal conflict risk, matching the level-5 anchor.

5 / 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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

pskoett/pskoett-ai-skills

Path

plugin/skills/learning-aggregator/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.