CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

81%

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 common-learning-log in HoangNguyen0403/agent-skills-standard

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 well-structured instruction-only skill with an actionable protocol, a concrete prevention-routing table, and exemplary progressive disclosure to a single real reference file. Its main weakness is redundancy: the no-auto-promotion / no-self-approval governance rules are repeated many times in both the body and the reference, inflating token cost without adding information.

Suggestions

Consolidate the promotion-governance rules stated in 'Route prevention', Guidelines ('No repeat-count promotion', 'Repeat mistakes append/extend proposed candidate', 'Independent maintainer review required'), and Anti-Patterns ('No auto-promotion on repeat mistakes', 'No self-authored promotion') into a single 'Promotion governance' rule, since they restate the same two constraints about six times.

Add an explicit post-append verification step to the Protocol (e.g. re-count iteration headers to confirm the new entry was written and the count is N+1) to close the workflow's only validation gap.

The 'Canonical response anchors' section reads as padding relative to its operational value; either fold the key terms into the Protocol or trim the trailing 'Additional task-grounded exact anchors' fragment.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive with no explanations of concepts Claude already knows, but the promotion-governance rule (repeats never auto-promote; no self-approval) is restated roughly six times across Protocol, Guidelines, and Anti-Patterns (e.g. "never promotes prose by itself", "No repeat-count promotion", "an AI agent cannot self-promote", "No auto-promotion on repeat mistakes", "No self-authored promotion"), and again in the reference file. Mostly efficient but could be consolidated into one statement.

3 / 5

Actionability

Guidance is fully executable for an instruction-only skill: "count existing `## Agent Learning Log: Iteration` headers → N", "write Iteration #(N+1) using [Log Entry Format](references/log-format.md)", a routing table mapping each correction shape to a mechanism with the exact evidence required, and a bootstrap template for a missing file. The reference file supplies a copy-paste-ready entry template covering the common cases.

5 / 5

Workflow Clarity

A clear six-step sequence (Detect signal → Redact → Read → Append → Route prevention → Continue) with a pre-write checkpoint (count existing iteration headers, create file if missing) and an append-only guardrail. It falls short of anchor 5 because there is no post-append validation step confirming the entry landed correctly, though this is a minor gap for a non-destructive append operation.

4 / 5

Progressive Disclosure

The body is a ~75-line overview that correctly defers the full entry template, improvement-item schema, and bootstrap header to a single one-level-deep reference, `references/log-format.md`, which exists in the bundle. The reference is clearly signaled twice in the Protocol and Guidelines and summarized in a dedicated References section with a description of its contents.

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 with an explicit what-and-when structure, natural trigger terms, and a clearly identifiable niche. Its main weaknesses are that it surfaces only one of the skill's several capabilities and its trigger list omits common synonyms, leaving modest overlap risk from generic words like "wrong".

Suggestions

Mention one or two more of the skill's actual capabilities, e.g. routing each correction to a preventive mechanism (lint rule, regression test, eval case) and linking repeat mistakes to an existing improvement item, to lift specificity beyond a single action.

Add missing natural trigger variations such as "oops", "screwed up", or "redo that" to broaden keyword coverage and reduce reliance on the generic word "wrong".

DimensionReasoningScore

Specificity

"Append a learning entry to AGENTS_LEARNING.md" names the domain and one concrete, file-targeted action, and the auto-activation clauses name three concrete trigger surfaces. However, the description covers only the append action — the routing of preventive mechanisms, improvement-item linking, and deduplication behavior in the body are not surfaced — so it matches anchor 3 (1-2 concrete actions, not comprehensive) rather than 4 (several specific actions).

3 / 5

Completeness

It clearly answers both questions: the "what" is "Append a learning entry to AGENTS_LEARNING.md", and the "when" is explicit twice — three concrete auto-activation conditions ("after a pre-write audit auto-fix, a retrospective correction loop, or a mid-session user correction") plus a "Use when:" clause with concrete trigger phrases. This matches the anchor-5 pattern of good examples and exceeds anchor 4, where the "when" is present but could be more explicit.

5 / 5

Trigger Term Quality

"Use when: mistake, wrong, correction, my bad, agent error, learning log" are natural phrases a user would actually say, giving good keyword coverage. It is not anchor 5 because common variations and synonyms are missing (e.g. "oops", "screwed up", "that's not right", "fix that").

4 / 5

Distinctiveness Conflict Risk

The niche is clear and mostly distinct — the AGENTS_LEARNING.md target, "agent error", "learning log", and named trigger skills (pre-write audit, retrospective) are unlikely to fire for unrelated skills. It is not anchor 5 because bare generic words like "wrong" and "correction" carry some overlap risk with general feedback, review, or correction skills.

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

Path

.agents/skills/common/common-learning-log/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.