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

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

71%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 a well-structured, actionable protocol for an instruction-only skill, with a clean numbered workflow and exemplary one-level-deep use of its single reference file. Its main cost is token efficiency: the Guidelines and Anti-Patterns sections restate the same guardrails (especially around promotion) several times over, and the "Canonical response anchors" section is vague filler.

Suggestions

Consolidate the promotion-safety rules: the no-auto-promotion / no-self-approval guidance is stated in Protocol steps 5–6, two Guidelines, and two Anti-Patterns; state it once in the Protocol and once as a single Anti-Pattern, cutting several lines of duplication.

Merge overlapping Guidelines and Anti-Patterns sections — roughly half the Anti-Patterns restate Guidelines (duplicate entries, duplicate rules, self-promotion); a single combined list would remove the redundancy without losing any rule.

Either operationalize or delete the "Canonical response anchors" section: as written ("Additional task-grounded exact anchors: Pre-write; trigger") it gives no actionable instruction; if it must be kept, show one worked example of how an anchor term is used in a real response.

DimensionReasoningScore

Conciseness

There is no educational padding, but the same guardrails are restated many times: the no-auto-promotion rule appears in Protocol steps 5–6, Guidelines ("No repeat-count promotion", "an AI agent cannot self-promote"), and two Anti-Patterns ("No auto-promotion on repeat mistakes", "No self-authored promotion"), and the 13 Guidelines and 8 Anti-Patterns overlap on roughly half their items. This is the "mostly efficient but could be tightened" profile of the 3 anchor rather than the padded explanations of 2.

3 / 5

Actionability

The protocol is concretely executable for an instruction-only skill — count "## Agent Learning Log: Iteration" headers to get N, append Iteration #(N+1) via the referenced template, route prevention via a decision table with evidence requirements — but two spots stay vague: the "Redact" step's "retain only minimal evidence references" and the cryptic "Canonical response anchors" section ("Additional task-grounded exact anchors: Pre-write; trigger") whose purpose and use are never operationalized.

4 / 5

Workflow Clarity

The 6-step Protocol (detect → redact → read/count → append → route prevention → continue) is clearly sequenced with most checkpoints present: iteration counting, default `proposed` status, evidence requirements per mechanism, and bootstrap-if-missing recovery. It falls short of the 5 anchor only because there is no explicit post-write validation of the appended entry; as an append-only logging skill it avoids the destructive/batch cap.

4 / 5

Progressive Disclosure

The body is a well-sectioned overview that keeps the full entry template, improvement-item schema, and bootstrap instructions in the real, verified references/log-format.md, referenced twice with purpose and summarized in a References section — exactly one level deep, clearly signaled, and appropriately split.

5 / 5

Total

16

/

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 action, an explicit "Use when" clause with natural trigger terms, and named auto-activation conditions in third-person voice. Its weaknesses are the single-action scope of capability coverage and trigger words broad enough to overlap with sibling feedback skills.

DimensionReasoningScore

Specificity

The description names one concrete action — "Append a learning entry to AGENTS_LEARNING.md" — which is appropriately specific, but a single-purpose skill yields only that one action rather than the several listed actions of the 4/5 anchors; the auto-activation contexts are triggers, not capabilities.

3 / 5

Completeness

It explicitly answers both questions: what ("Append a learning entry to AGENTS_LEARNING.md") and when (an explicit "Use when:" clause with concrete trigger phrases, plus three named auto-activation conditions). This matches the 5 anchor's "both what AND when with concrete trigger phrases" exactly; the 4 anchor's "when could be more explicit" does not apply here.

5 / 5

Trigger Term Quality

"Use when: mistake, wrong, correction, my bad, agent error, learning log" includes natural phrases a user or agent would actually say (even colloquial "my bad"), but misses common variations like "redo", "oops", or bare "error" that appear in comparable descriptions. Not comprehensive enough for the 5 anchor's synonym coverage, but clearly above the partial coverage of 3.

4 / 5

Distinctiveness Conflict Risk

The niche (structured mistake logging to a specific file) is clear and mostly distinct, but generic trigger words like "mistake" and "wrong" overlap with closely related feedback/retrospective skills the body itself references (common-feedback-reporter, common-session-retrospective), matching the 4 anchor's "minor overlap risk with closely related skills" rather than the 5 anchor's minimal conflict risk.

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

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