new-note

Interactively create a vault note with guided type selection, tags, and template. Triggers: "create a note about", "new note", "add a note on", "start writing about", "I want to document", "write up", "jot down". For quick capture without prompts, use auto-categorize instead.

Quality

83%

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

76%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 content is a tight, well-structured instruction skill with concrete paths and an explicit efficiency shortcut. Its weak points are the missing verification checkpoint after writing the note file and a promised fallback table that was not actually included.

Suggestions

Add a verification checkpoint after step 6 (e.g., re-read the written file and confirm frontmatter has title, type, tags, created, and status: active before reporting success) to lift workflow_clarity above 3.

Include a short example of the final frontmatter/output for a sample note so the generate-and-write steps are copy-paste ready and actionability reaches 5.

Either fill in the promised fallback type-mapping table under "Template mapping" or remove that section header so structure matches the delivered content and progressive_disclosure reaches 5.

Dimension	Reasoning	Score
Conciseness	The body is lean with no concept-padding: every line ("Load schema", "Generate", "Write") is actionable instruction and assumes Claude's competence, matching the lean/efficient anchor 5.	5 / 5
Actionability	Steps cite concrete paths ("CLAUDE.md", "Templates/<Type>.md", "Notes/<type>/<kebab-case-title>.md") and specific frontmatter fields ("status: active"), but there is no example of the resulting filled frontmatter/output to copy, leaving a minor gap below the fully copy-paste-ready anchor 5.	4 / 5
Workflow Clarity	The six steps form a clear sequence with a final confirm step, but the write-to-disk step has no validation/verification checkpoint (e.g., confirm the file exists and frontmatter is well-formed), which the rubric's missing-checkpoint guidance holds at anchor 3.	3 / 5
Progressive Disclosure	Under 50 lines, single-purpose, and well-organized into Workflow / Efficiency shortcut / Template mapping sections with no bundle files needed; the simple-skill exception would allow a 5, but the "Template mapping (fallback reference)" section header promises a table that is absent, a minor organization gap keeping it at 4.	4 / 5
	Total	16 / 20 Passed

Description

91%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.

The description is strong: it pairs a clear capability statement with an explicit, well-chosen set of natural trigger phrases and correctly steers the overlapping quick-capture case elsewhere. It is concise, third-person, and low-conflict; the only weakness is moderate specificity (capabilities could enumerate frontmatter/output).

Dimension	Reasoning	Score
Specificity	"guided type selection, tags, and template" names the domain plus several concrete actions (type selection, tagging, templating); falls just short of comprehensive coverage (no mention of frontmatter or file output), so it sits above anchor 3 but below 5.	4 / 5
Completeness	It states clearly what the skill does ("Interactively create a vault note with guided type selection, tags, and template") and gives an explicit Triggers clause for when to use it, satisfying both halves of anchor 5.	5 / 5
Trigger Term Quality	The Triggers clause lists seven natural, user-sayable phrases ("create a note about", "new note", "add a note on", "start writing about", "I want to document", "write up", "jot down") including synonyms, matching the comprehensive-coverage anchor 5.	5 / 5
Distinctiveness Conflict Risk	The "vault note" niche with distinct trigger phrases is mostly distinct, but the explicit steer toward the sibling "auto-categorize" skill for quick capture signals a real overlap risk with that related skill, keeping it at anchor 4 rather than 5.	4 / 5
	Total	18 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: seanGSISG/claude-depot
Path: plugins/vault-tools/skills/new-note/SKILL.md
Commit: 48bf6a4

Reviewed: 4 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.