CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

continuous-learning-v2

Instinct-based learning system that observes sessions via hooks, creates atomic instincts with confidence scoring, and evolves them into skills/commands/agents. v2.1 adds project-scoped instincts to prevent cross-project contamination.

Quality

65%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/continuous-learning-v2/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 a well-organized, largely executable overview of the instinct system with strong tables and copy-paste configuration, but it is diluted by changelog and advocacy content, lacks validation checkpoints in its setup workflow, and doesn't leverage progressive disclosure — everything is inline and bundle file references are incomplete (observe.sh missing). Scores cluster at 3-4, indicating a solid skill with clear tightening opportunities.

Suggestions

Move the version-history tables ("What's New in v2.1", "What's New in v2 (vs v1)"), the "Why Hooks vs Skills" rationale, and the Backward Compatibility section into a CHANGELOG.md or references/ file, keeping SKILL.md focused on current-state operation.

Add an explicit validation step to the Quick Start (e.g., "run /instinct-status or check projects/<hash>/observations.jsonl to confirm hooks are firing") so users can verify setup succeeded before moving on.

Fix bundle references: either ship hooks/observe.sh or correct the hook config path, link to the actual scripts (instinct-cli.py, detect-project.sh), and consider splitting the Scope Decision Guide and Confidence Scoring reference tables into references/ files with clear one-level-deep links.

DimensionReasoningScore

Conciseness

The operational core (Quick Start, Commands, Configuration, File Structure, Scope Guide, Confidence Scoring) is efficient and table-based, but it is padded with two version-history tables ("What's New in v2.1", "What's New in v2 (vs v1)"), a marketing-flavored "Why Hooks vs Skills" section ("Hooks fire 100% of the time, deterministically"), Backward Compatibility notes, and a closing tagline. The version-comparison tables are time-sensitive changelog content not placed in a deprecated/old-patterns section, which the guidelines penalize. This fits anchor 3 (mostly efficient, some unnecessary content that could be tightened) better than anchor 2, since the majority of the body is actionable operational reference rather than padding.

3 / 5

Actionability

Mostly executable guidance: copy-paste JSON hook configs for both plugin and manual installs, a mkdir command, concrete promote invocations with flags ("python3 instinct-cli.py promote --dry-run"), a config.json example with a key table, and a full command table. It falls short of anchor 5 because the Quick Start's hook config points at "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/hooks/observe.sh", which does not exist in the bundle, and the six slash commands have no defined file locations — gaps a user must resolve to actually run the system.

4 / 5

Workflow Clarity

A sequence is present (numbered Quick Start: enable hooks -> initialize directories -> use commands) and the observe->analyze->instinct->evolve pipeline is diagrammed, but validation checkpoints are missing or implicit: there is no step to verify hooks fired or that observations.jsonl is being written after setup. Only promote offers a checkpoint (--dry-run), and evolve has no feedback loop. This matches anchor 3 (steps listed but validation gaps) better than anchor 4, whose example includes an explicit verify step.

3 / 5

Progressive Disclosure

Section headers are clear and consistent, but everything is inlined in a single ~360-line SKILL.md with no references/ directory: version-history tables, the detailed file tree, the scope decision guide, and confidence-scoring reference material are all inline content that could be split out. Bundle references are not clearly signaled — "instinct-cli.py" and "observe.sh" are mentioned by name without links (and observe.sh is missing from the bundle while the existing scripts/detect-project.sh is never referenced). This fits anchor 3 (some structure, references present but not clearly signaled, content that should be separate is inline).

3 / 5

Total

13

/

20

Passed

Description

58%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.

The description communicates a clear, specific "what" in third person with concrete actions and a distinctive niche, but it omits any "when to use" guidance and lacks the natural trigger phrasings users would say when they need it. These gaps hold it to the middle of the scale despite strong specificity.

Suggestions

Append an explicit trigger clause, e.g., "Use when setting up automatic learning from Claude Code sessions, tuning confidence thresholds for learned behaviors, or managing instinct libraries."

Add natural user phrasings and synonyms such as "learn from my sessions", "remember my patterns", or "continuous learning" so the description matches how users actually ask for it.

Mention the export/import and promotion capabilities to round out coverage of what the skill does.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "observes sessions via hooks", "creates atomic instincts with confidence scoring", "evolves them into skills/commands/agents", and "adds project-scoped instincts to prevent cross-project contamination" — in third-person voice. It stops short of anchor 5 because capabilities documented in the body (exporting/importing instinct libraries, promotion to global scope) are not covered, leaving minor gaps.

4 / 5

Completeness

The "what" is clearly and concretely answered (observe sessions, create instincts, evolve into skills/commands/agents), but there is no "Use when..." clause or equivalent explicit trigger guidance anywhere in the description. Per the judging guidelines, a missing use-when clause caps completeness at 3, which also rules out anchor 4.

3 / 5

Trigger Term Quality

Relevant keywords exist ("learning", "instincts", "hooks", "confidence scoring", "skills/commands/agents"), but the natural phrases a user would actually say — "learn from my sessions", "remember my patterns", "continuous learning" — and common synonyms are missing. This matches anchor 3 (some relevant keywords but missing common variations or synonyms) rather than anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — an instinct-based learning system with project scoping is unlikely to trigger for unrelated skills, and "instinct" terminology is unusual. It is not anchor 5 because the broad learning/memory domain ("learning system", "evolves them into skills") has some overlap risk with other session-memory or skill-management skills.

4 / 5

Total

14

/

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

valeriibeck-star/claude-skills

Path

skills/continuous-learning-v2/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.