Knowledge base management, ingestion, sync, and retrieval across multiple storage layers (local files, MCP memory, vector stores, Git repos). Use when the user wants to save, organize, sync, deduplicate, or search across their knowledge systems.
76
76%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Quality
Discovery
92%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 what the skill does and when to use it, with good specificity about both actions and storage layers. The explicit 'Use when' clause with multiple trigger terms is well-constructed. The main weakness is moderate overlap risk with file management or search-oriented skills due to some generic trigger terms like 'save' and 'organize'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: management, ingestion, sync, retrieval, save, organize, sync, deduplicate, search. Also specifies concrete storage layers (local files, MCP memory, vector stores, Git repos). | 3 / 3 |
Completeness | Clearly answers both 'what' (knowledge base management, ingestion, sync, and retrieval across multiple storage layers) and 'when' (explicit 'Use when' clause with specific trigger scenarios: save, organize, sync, deduplicate, or search across knowledge systems). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'save', 'organize', 'sync', 'search', 'knowledge base', 'deduplicate', 'knowledge systems'. Also mentions specific storage types (vector stores, Git repos, MCP memory) that technically-minded users would reference. | 3 / 3 |
Distinctiveness Conflict Risk | While the multi-layer storage aspect and 'knowledge base' framing are fairly distinctive, terms like 'save', 'organize', and 'search' are generic enough to potentially overlap with file management, note-taking, or general search skills. The mention of specific storage layers (MCP memory, vector stores) helps but doesn't fully eliminate conflict risk. | 2 / 3 |
Total | 11 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a comprehensive knowledge management framework with a well-thought-out multi-layer architecture and clear classification system. Its main weaknesses are the lack of executable code examples (relying on conceptual descriptions instead), missing validation/feedback loops in sync operations, and a monolithic structure that could benefit from progressive disclosure via external references. The content is moderately concise but could be tightened by removing some explanatory text that Claude would already understand.
Suggestions
Add executable code or command examples for key operations (e.g., actual MCP tool invocations with sample parameters, Git commands for sync operations, example frontmatter YAML for memory files).
Add explicit validation and error recovery steps to sync operations—e.g., 'If push fails due to conflicts: pull, resolve, re-validate, then push again.'
Split detailed layer descriptions and sync procedures into referenced sub-files (e.g., SYNC.md, ARCHITECTURE.md) to keep SKILL.md as a concise overview with navigation links.
Tighten the architecture section by removing explanatory phrases like 'Use for:' descriptions that Claude can infer from the layer names and rules.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but includes some unnecessary elaboration. The architecture section with 6 layers is somewhat verbose with explanations Claude could infer, and some bullet points restate obvious principles. However, it avoids egregious padding and most content is informational rather than explanatory. | 2 / 3 |
Actionability | The skill provides structured guidance with specific tool names (mcp__memory__create_entities, etc.) and file paths, but lacks executable code examples. The ingestion workflow and sync operations describe what to do at a conceptual level rather than providing copy-paste commands or concrete code snippets. The Memory Patterns section uses comments rather than executable examples. | 2 / 3 |
Workflow Clarity | The ingestion workflow has a clear 4-step sequence (Classify → Deduplicate → Store → Index) and there's a Quality Gate section acting as validation. However, the sync operations lack explicit validation checkpoints and error recovery steps. For operations involving Git commits and database writes, the absence of feedback loops (validate → fix → retry) is notable. | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear headers and sections, making it easy to scan. However, it's a fairly long monolithic document with no references to external files for detailed procedures. The 6-layer architecture, multiple sync operations, and best practices could benefit from being split into referenced sub-documents rather than all being inline. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
Reviewed
Table of Contents