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. Use when capturing lessons from a session, managing instincts, or promoting them into skills, commands, or agents.

Quality

72%

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

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-organized and largely actionable, with concrete setup code, configuration tables, and a dry-run checkpoint on the riskiest batch operation. Its main problems are verbosity — duplicated changelog tables, a repeated command listing, and an inlined architecture diagram — and a progressive-disclosure gap where several referenced artifacts (hooks/observe.sh, the six commands, config.json) are not present in the bundle.

Suggestions

Move both version-comparison tables (v2 vs v1, v2.1 vs v2.0) into a CHANGELOG.md or references/ file and delete the duplicate command listing (Quick Start step 3 vs the Commands table), keeping one copy.

Fix the referenced-path mismatches: ship or correct the paths to hooks/observe.sh, hooks/hooks.json, the six slash commands, and the skill-level config.json, or note where they live in a plugin install.

Add a verification step after hook setup (e.g., "run any tool call, then confirm projects/<hash>/observations.jsonl gained a line") so the setup workflow has an explicit checkpoint.

Repair the broken title line-wrap ("# Continuous Learning v2.1 - Instinct" / "-Based Architecture") and trim the pull-quote section to a single sentence.

DimensionReasoningScore

Conciseness

The 377-line body carries several padded sections: two version-comparison changelog tables ("What's New in v2.1", "What's New in v2 (vs v1)") whose version-number/time-sensitive content is penalized outside a deprecated section, a 45-line ASCII architecture diagram, a marketing-style "Why Hooks vs Skills for Observation?" section with a pull-quote, and the six commands listed twice (Quick Start step 3 and the Commands table). This matches the 'noticeably verbose; several unnecessary explanations or padded sections' anchor rather than 3, because the padding is repeated in kind (two changelogs, duplicate command listing) rather than isolated over-explanation.

2 / 5

Actionability

Mostly executable guidance: a copy-paste-ready settings.json hook block, a mkdir command with the exact XDG path, concrete CLI invocations ("python3 instinct-cli.py promote prefer-explicit-errors", "--dry-run"), and a config.json example with a key/default table. It falls short of 5 due to minor gaps — `instinct-cli.py` is invoked without its `scripts/` path, the "Edit `config.json`" target isn't located, and the six slash commands are named without any usage detail — but stays above 3 because the core setup steps are complete and runnable as written.

4 / 5

Workflow Clarity

The Quick Start is a clearly sequenced three-step path (enable hooks, with both plugin and manual install branches plus a de-duplication warning; initialize directories; use commands), and the promotion workflow includes an explicit preview checkpoint ("promote --dry-run" / "Preview without changes") for a batch operation. It is not 5 because there is no step to verify the hooks actually fire after setup (e.g., checking observations.jsonl grows), and no error-recovery loop if the observer fails beyond the Windows-specific note; it is above 3 because the dry-run checkpoint and the observe-failure warning cover the riskiest operations.

4 / 5

Progressive Disclosure

Section structure is good (When to Activate, Quick Start, Configuration, File Structure, Scope Decision Guide), and one referenced path resolves (scripts/migrate-homunculus.sh exists), but several referenced paths do not exist in the bundle — `hooks/observe.sh` and `hooks/hooks.json` (no hooks/ directory), the six documented slash commands (no commands/ directory), and the skill-level `config.json` — and changelog tables plus the architecture diagram are inlined where reference files would serve better. This fits 'some structure but could be better organized; references present but not clearly signaled', not 4 (too many dangling references for 'references mostly clear') and not 2 (section organization is solid, not minimal).

3 / 5

Total

13

/

20

Passed

Description

76%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 explicitly answers both what the system does and when to use it, with mostly concrete action language. Its weaknesses are reliance on system-specific jargon ("instincts", "confidence scoring") as trigger terms rather than natural user phrasing, and a version-note sentence ("v2.1 adds project-scoped instincts...") that adds little for trigger matching.

Suggestions

Add natural-language trigger synonyms users would actually say, e.g. "Use when the user wants Claude to learn from this session, save lessons or patterns, or turn repeated corrections into reusable skills, commands, or agents".

Drop or compress the versioning sentence ("v2.1 adds project-scoped instincts to prevent cross-project contamination") — release notes don't help trigger matching and crowd the description.

Ground the abstract term "instincts" once (e.g. "small learned behaviors") so the description is self-explanatory to users who haven't used the system before.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "observes sessions via hooks", "creates atomic instincts with confidence scoring", "evolves them into skills/commands/agents" — which matches the 'several specific actions with minor gaps' anchor. It falls short of 5 because "instinct" and "confidence scoring" are system-internal concepts whose practical effect is never grounded, and below-5 is confirmed since coverage of what the user actually experiences (commands, review, export/import) is partial.

4 / 5

Completeness

Both halves are explicit: the what ("observes sessions via hooks, creates atomic instincts with confidence scoring, and evolves them into skills/commands/agents") and an explicit "Use when..." clause with concrete trigger phrases ("capturing lessons from a session, managing instincts, or promoting them into skills, commands, or agents"). This matches the anchor-5 example's structure; a 4 would require the 'when' to be weaker or less explicit, which is not the case here.

5 / 5

Trigger Term Quality

"Use when capturing lessons from a session, managing instincts, or promoting them into skills, commands, or agents" provides some relevant keywords, but "instincts" and "promoting" are this system's own jargon rather than phrases a user would naturally say, and common variations like "learn from this session", "remember this pattern", or "save lessons" are absent. This fits the 'some relevant keywords but missing common variations or synonyms' anchor, not 4 (which would require broader natural-term coverage) or 2 (keywords exist and are on-target, not generic).

3 / 5

Distinctiveness Conflict Risk

The instinct-capture/promotion niche with specific trigger phrases ("capturing lessons", "promoting them into skills, commands, or agents") is mostly distinct with only minor overlap risk against generic memory or session-summary skills. Not 5 because "learning system" and "skills/commands/agents" are broad enough that a request like "turn this into a skill" could plausibly route to skill-authoring skills instead; not 3 because the triggers are considerably more specific than the 'somewhat specific but could overlap' anchor.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

affaan-m/ECC

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.