CtrlK
BlogDocsLog inGet started
Tessl Logo

common-learning-log

Append a structured learning entry to AGENTS_LEARNING.md whenever an AI agent makes a mistake. Auto-activates as a composite skill when: a pre-write audit violation is detected and auto-fixed, or when the session retrospective finds a correction loop. Also triggers directly when the user corrects the AI mid-session. Use when: mistake, wrong, redo, that's not right, correction, my bad, fix that error, I made a mistake, agent error, learning log, log mistake, AGENTS_LEARNING.md

68

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is well-structured, lean, and uses progressive disclosure effectively with a real reference file. The main weakness is minor typos/incomplete sentences in the Guidelines that slightly reduce actionability.

Suggestions

Fix the incomplete/typo sentences in Guidelines (e.g., "action that wrong" → "action that was wrong"; "must actionable" → "must be actionable"; "state what to , not" → "state what to do, not").

Inline a minimal entry skeleton or at least name the key sections (Mistake Made / Pattern to Avoid / Better Approach) so the body is actionable without forcing a reference hop.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — a short priority line, a 4-step protocol, tight guidelines, and anti-patterns — with no padding or explanation of concepts Claude already knows.

3 / 3

Actionability

Steps are concrete (count "## Agent Learning Log: Iteration" headers to N, append Iteration #(N+1) using the referenced format), but inline guidance has incomplete/typo-ridden sentences ("action that wrong", "must actionable", "state what to , not what to avoid") that slightly undercut copy-paste-ready actionability.

2 / 3

Workflow Clarity

For a simple single-task skill the 4-step sequence (Detect signal → Read/count → Append → Continue) is clear and well-organized with supporting rules and anti-patterns; the append-only operation is low-risk so explicit validation checkpoints are not required.

3 / 3

Progressive Disclosure

The SKILL.md is a concise overview that points to one real, one-level-deep reference (references/log-format.md, linked twice with clear labels), and that bundle file exists, giving easy navigation without nesting.

3 / 3

Total

11

/

12

Passed

Description

82%

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 is strong on completeness and natural trigger terms, cleanly answering both what and when. It is slightly weak on specificity (one core action) and has modest conflict risk from generic correction keywords.

Suggestions

Add one or two more concrete actions (e.g., "counts existing iterations, appends an Iteration block, bootstraps the file if missing") to lift specificity.

Tighten trigger terms so "wrong"/"redo"/"fix that error" are less likely to fire for ordinary fixes that do not merit a learning entry, reducing overlap with general correction skills.

DimensionReasoningScore

Specificity

It names one concrete action ("Append a structured learning entry to AGENTS_LEARNING.md") but does not enumerate multiple distinct concrete actions, so it lands in the "names domain and some actions" band rather than listing several specific capabilities.

2 / 3

Completeness

It explicitly answers both what ("Append a structured learning entry to AGENTS_LEARNING.md") and when ("Auto-activates as a composite skill when... Also triggers directly when the user corrects the AI mid-session. Use when:...").

3 / 3

Trigger Term Quality

The "Use when" clause gives broad natural coverage — "mistake, wrong, redo, that's not right, correction, my bad, fix that error, I made a mistake, agent error, learning log, log mistake" — phrases a user would actually say, plus the file trigger AGENTS_LEARNING.md.

3 / 3

Distinctiveness Conflict Risk

The AGENTS_LEARNING.md file target gives it a clear niche, but broad trigger words like "wrong", "redo", and "fix that error" could plausibly fire for ordinary fix/correction requests that do not warrant logging, creating overlap with other correction-oriented skills.

2 / 3

Total

10

/

12

Passed

Validation

87%

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

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

Total

14

/

16

Passed

Repository
HoangNguyen0403/agent-skills-standard
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.