Capture meeting and coding session notes into indexed per-event markdown files with structured retrieval.
88
88%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
85%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 a strong description that clearly articulates specific capabilities (capture, index, retrieve) and provides explicit trigger guidance. The main weakness is that the trigger terms could be broader to capture more natural user phrasings like 'meeting minutes', 'standup notes', or 'find my notes from last week'.
Suggestions
Expand trigger terms to include common variations like 'meeting minutes', 'standup notes', 'journal', 'find notes', or 'look up past sessions' to improve discoverability.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: captures notes into per-event markdown files, maintains a searchable index table, and retrieves past notes by date/tag/keyword. These are distinct, well-defined capabilities. | 3 / 3 |
Completeness | Clearly answers both what (captures meeting/coding session notes into markdown files, maintains searchable index, retrieves by date/tag/keyword) and when ('Use when taking notes, logging sessions, or searching past entries') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes some natural terms like 'notes', 'sessions', 'searching past entries', 'meeting', 'coding session', but misses common variations users might say such as 'meeting minutes', 'standup notes', 'log', 'journal', 'lookup', or 'find notes'. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of meeting/coding session notes, per-event markdown files, searchable index table, and retrieval by date/tag/keyword creates a clear niche that is unlikely to conflict with generic note-taking or document management skills. | 3 / 3 |
Total | 11 / 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, actionable skill with clear workflows for both capture and retrieval modes, concrete file templates, and good error handling. Its main weakness is redundancy in emphasizing the 'no questions' rule, which is stated three separate times in slightly different forms, wasting tokens. Overall it's a strong skill that could benefit from minor deduplication.
Suggestions
Consolidate the 'ZERO QUESTIONS RULE', 'CRITICAL' block, and the Constraints bullet about never asking questions into a single, prominent statement to reduce redundancy and save tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient but has some redundancy — the 'ZERO QUESTIONS RULE' is stated three times in different forms (the rule itself, the CRITICAL block, and again in Constraints). The batching rule and critical block also overlap. Some tightening would improve token efficiency. | 2 / 3 |
Actionability | The skill provides concrete file formats, exact directory paths, specific markdown templates for both note files and the index table, slug generation rules, and collision handling. The guidance is specific and directly executable without ambiguity. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced with distinct modes (Capture vs Retrieve), numbered steps within each mode, and explicit validation/error handling (malformed index rebuild, write failure handling, existence checks). The batching rule provides a clear checkpoint mechanism (write only on 'done'). | 3 / 3 |
Progressive Disclosure | For a skill of this size (~80 lines), the content is well-organized with clear sections (Storage layout, Steps with sub-modes, Error handling, Constraints). No external references are needed, and the structure allows quick scanning. The content is appropriately scoped for a single file. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Reviewed
Table of Contents