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 skill 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
92
92%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly defines a specific niche (logging AI agent mistakes to AGENTS_LEARNING.md), provides comprehensive trigger conditions covering both automatic and manual activation scenarios, and includes a rich set of natural trigger terms. The description is well-structured, uses third person voice appropriately, and would be easily distinguishable from other skills in a large skill library.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description lists multiple specific concrete actions: 'Append a structured learning entry to AGENTS_LEARNING.md', 'pre-write skill violation is detected and auto-fixed', 'session retrospective finds a correction loop', and 'user corrects the AI mid-session'. These are highly specific and actionable. | 3 / 3 |
Completeness | Clearly answers both 'what' (append a structured learning entry to AGENTS_LEARNING.md when an AI agent makes a mistake) and 'when' (explicit 'Use when:' clause with multiple trigger scenarios and terms, plus 'Auto-activates' conditions). Both dimensions are thoroughly covered. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'mistake', 'wrong', 'redo', 'that's not right', 'correction', 'my bad', 'fix that error', 'I made a mistake', 'agent error', 'learning log', 'log mistake', and the specific file 'AGENTS_LEARNING.md'. These are very natural phrases a user would use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche: logging AI agent mistakes to a specific file (AGENTS_LEARNING.md). The combination of error-logging, agent self-reflection, and the specific file target makes it very unlikely to conflict with other skills like general error-fixing or code debugging skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill that efficiently communicates a clear workflow for logging agent mistakes. Its main weakness is the lack of an inline example showing what a completed log entry looks like—the entire format is deferred to a reference file, which reduces immediate actionability. There are also a few minor typos/incomplete sentences in the guidelines section that slightly hurt clarity.
Suggestions
Add a brief inline example of a completed log entry (even a minimal 3-4 line snippet) so Claude can execute without needing to read the reference file for basic cases.
Fix incomplete sentences in Guidelines: 'state what to , not what to avoid' and 'all corrections learning signals' appear to have missing words.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient. Every section serves a purpose—protocol steps, guidelines, and anti-patterns are all tightly written without explaining concepts Claude already knows. Minor typos exist ('what to' instead of 'what to do') but no unnecessary verbosity. | 3 / 3 |
Actionability | The protocol steps are clear and specific (read file, count headers, append entry), but the actual log entry format is deferred entirely to a reference file. There's no inline example of what a completed entry looks like, making it harder to execute without the reference. The guidelines have a few incomplete sentences ('state what to , not what to avoid') reducing clarity. | 2 / 3 |
Workflow Clarity | The 4-step protocol is clearly sequenced with explicit trigger detection, state reading, writing, and continuation. The workflow includes the important constraint of 'write before retrying' which serves as a validation checkpoint. The non-blocking nature is explicitly stated. For this type of append-only, non-destructive operation, the workflow is appropriately detailed. | 3 / 3 |
Progressive Disclosure | The skill provides a clear overview with the protocol and guidelines inline, while appropriately deferring the detailed log entry template to a single reference file (references/log-format.md). References are one level deep and clearly signaled. Content is well-split between what's needed immediately and what's needed for detailed formatting. | 3 / 3 |
Total | 11 / 12 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 — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 9 / 11 Passed | |
4c72e76
Table of Contents
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.