CtrlK
BlogDocsLog inGet started
Tessl Logo

common-learning-log

Append a learning entry to AGENTS_LEARNING.md when an AI agent makes a mistake. Auto-activates after a pre-write audit auto-fix, a retrospective correction loop, or a mid-session user correction. Use when: mistake, wrong, correction, my bad, agent error, learning log.

64

Quality

78%

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 ./.github/skills/common/common-learning-log/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 compact, well-structured instruction skill with a clear protocol and exemplary one-level-deep reference usage. Its main defects are textual: several guideline bullets contain broken sentences with missing words, and the Guidelines/Anti-Patterns sections repeat each other.

Suggestions

Fix the garbled guideline sentences so every instruction is complete — e.g. "'Better Approach' must be actionable — state what to do, not what to avoid" and "name the specific file, rule, or action that was wrong".

Deduplicate Guidelines and Anti-Patterns: the one-entry-per-event rule and the promote-on-second-entry rule each appear in both sections; state each once and cross-reference.

Add a verification checkpoint after the Redact step (e.g. re-read the drafted entry for credentials/customer identifiers before appending) since persistence of sensitive data is the one risky operation in the workflow.

DimensionReasoningScore

Conciseness

The body is lean and imperative — short Protocol steps, bullet Guidelines, no explanations of concepts Claude already knows. It misses anchor 5 because Guidelines and Anti-Patterns overlap ("One entry per correction event" vs "No duplicate entries"; the promote-on-second-entry rule appears in both), and the "Canonical response anchors" section adds marginal value.

4 / 5

Actionability

Guidance is mostly concrete and executable: exact file name, the header pattern to count ("## Agent Learning Log: Iteration" headers → N), Iteration #(N+1), default status `proposed`, and the promotion rule. Not anchor 5 because several guideline sentences are garbled and lose their operative words — "'Better Approach' must actionable — state what to , not what to avoid" and "name specific file, rule, or action that wrong" — leaving a reader to reconstruct the instruction.

4 / 5

Workflow Clarity

The Protocol is a clear 5-step sequence (Detect signal → Redact → Read/count → Append → Continue) with a concrete signal taxonomy for step 1. Not anchor 5 because the redaction step (the one risky operation, since sensitive data is being persisted) has no verification checkpoint, and there is no check that the appended entry is well-formed.

4 / 5

Progressive Disclosure

The body is a well-organized ~70-line overview that correctly delegates the entry template, bootstrap text, and signal taxonomy to references/log-format.md, which exists and matches, referenced three times with clear labels ([Log Entry Format](references/log-format.md)). References are one level deep with no nesting — this matches the anchor-5 example structure.

5 / 5

Total

17

/

20

Passed

Description

78%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 states a single concrete capability and gives explicit, natural trigger terms in a proper 'Use when' clause. The main gap is that it describes only one action without hinting at the fuller workflow (entry format, iteration counting, promotion) that the skill body actually covers.

DimensionReasoningScore

Specificity

The description names one concrete action — "Append a learning entry to AGENTS_LEARNING.md" — plus the trigger surfaces ("pre-write audit auto-fix, a retrospective correction loop, or a mid-session user correction"), but those surfaces are when-conditions rather than capabilities, so action coverage is not comprehensive. It sits at anchor 3 (domain + 1-2 concrete actions); not 4 because it never says what the entry contains or what happens after (promotion, iteration counting).

3 / 5

Completeness

It explicitly answers what ("Append a learning entry to AGENTS_LEARNING.md when an AI agent makes a mistake") and when ("Auto-activates after a pre-write audit auto-fix, a retrospective correction loop, or a mid-session user correction. Use when: mistake, wrong, correction, my bad, agent error, learning log") with concrete trigger phrases. This matches the anchor-5 example pattern of what + explicit 'Use when' with trigger terms; not below 5 since neither half is vague.

5 / 5

Trigger Term Quality

"Use when: mistake, wrong, correction, my bad, agent error, learning log" covers natural phrases a user would actually say, including the colloquial "my bad". It falls short of anchor 5 because common variations like "oops", "that's not right", or "redo" (which appears in the frontmatter metadata but not the description) are absent.

4 / 5

Distinctiveness Conflict Risk

The target file (AGENTS_LEARNING.md) and the agent-mistake niche are distinct from typical user-facing skills. However, generic trigger words like "mistake", "wrong", and "correction" could overlap with other feedback/retrospective skills, matching anchor 4 (mostly distinct, minor overlap risk) rather than 5 (clear niche with minimal conflict).

4 / 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
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.