knowledge-base

Create and maintain a Markdown knowledge base that any AI agent can read, search, and update. Use when the user wants to start a knowledge base, add or update notes, organize docs/notes for an agent or LLM to consume, build an index of notes, or run a cleanup/maintenance pass on an existing MD knowledge base. Triggers include "knowledge base", "KB", "notes for the agent", "index of notes", "second brain", "docs for AI context", "add a note", "update the KB".

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

88%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, highly actionable skill body with concrete templates, named tool calls, sequenced workflows, validation checkpoints, and a finishing checklist. It is token-efficient and assumes Claude's competence, with only minor room to tighten rationale clauses and possibly externalize the larger templates.

Suggestions

Tighten rationale clauses in 'Core principles' (e.g. drop 'Atomic notes are easier to find, link, and reuse') to recover a few tokens without losing guidance.

Consider moving the full INDEX.md and _topic.md templates into a referenced file under references/ so the SKILL.md body stays a lean overview, which would also strengthen progressive disclosure.

In the maintenance pass, make the per-category validation step explicit as a numbered 'verify' checkpoint (mirroring the checklist) rather than prose, to make the feedback loop scannable.

Dimension	Reasoning	Score
Conciseness	Lean and high-signal with no concept-padding Claude already knows, but a few rationale clauses (e.g. 'Atomic notes are easier to find, link, and reuse') and repeated emphasis on lean instructions could be trimmed slightly.	4 / 5
Actionability	Fully executable guidance: copy-paste-ready frontmatter, note-body, INDEX.md, and _topic.md templates plus concrete tool calls (write_file, edit_block, start_search, get_file_info, list_directory, read_multiple_files) cover the common cases.	5 / 5
Workflow Clarity	Sequenced workflows for create/add/update/maintenance with explicit validation (confirming registry paths and related targets via get_file_info), feedback loops for orphans and broken links, and a finishing checklist — validation is present so the batch/destructive cap does not apply.	5 / 5
Progressive Disclosure	Well-organized into clear sections with no nested references and no bundle files, but at ~180 lines with several large inline templates the body is denser than a simple skill, so the simple-skill exception does not fully apply.	4 / 5
	Total	18 / 20 Passed

Description

100%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, third-person description that clearly states capabilities, provides rich natural trigger phrases with synonyms, and explicitly separates 'what' from 'when'. It is distinct from other skills and free of vague fluff.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'start a knowledge base', 'add or update notes', 'organize docs/notes', 'build an index of notes', 'run a cleanup/maintenance pass' — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both 'what' ('Create and maintain a Markdown knowledge base that any AI agent can read, search, and update') and 'when' ('Use when the user wants to…') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Provides comprehensive natural triggers with synonyms users would actually say: 'knowledge base', 'KB', 'notes for the agent', 'index of notes', 'second brain', 'docs for AI context', 'add a note', 'update the KB'.	5 / 5
Distinctiveness Conflict Risk	Carves a clear niche (agent-readable Markdown knowledge base) with distinctive triggers like 'second brain', 'KB', and 'notes for the agent', minimizing overlap with other skills.	5 / 5
	Total	20 / 20 Passed

Validation

87%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
relative_links	Relative link issues: 3 missing, 1 suspicious	Warning

	Total	14 / 16 Passed

Repository: wonderwhy-er/DesktopCommanderMCP
Path: plugins/claude/skills/knowledge-base/SKILL.md
Commit: 9bd8422

Reviewed: 8 days ago

Table of Contents

Discovery Implementation Validation

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.