knap

Render Markdown from templates and structured data using Knap CLI. Use when the user asks to apply a Knap template, turn JSON or CSV data into notes, batch-generate Markdown files, or format Defuddle output into a note.

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

90%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 an efficient, fully executable reference for the Knap CLI with clear section structure and built-in validation guidance. Its only gaps are framing validation as an explicit feedback loop and considering whether any detail warrants a bundled reference file.

Suggestions

Add an explicit batch-rendering checkpoint sequence (e.g., 'run `knap validate` first; for batches use `--dry-run`, then re-run with `--overwrite` only if paths look right') to turn the existing validation tools into a clear validate→fix→retry loop.

Consider splitting the template-syntax/filter reference (the `yaml_property`, `safe_name`, `{{ }}`/`{% %}` details) into a bundled reference file with a clearly signaled pointer, which would raise progressive disclosure toward the top anchor.

Dimension	Reasoning	Score
Conciseness	The body is lean and information-dense — it documents commands and behavior without explaining concepts Claude already knows (no 'what is JSON' or 'how templates work' padding), so every token earns its place.	5 / 5
Actionability	Commands are copy-paste ready and cover the common cases — single render, inline template, --set override, stdin piping, validate, Defuddle pipeline, and batch with --dry-run — fully executable guidance.	5 / 5
Workflow Clarity	Validation tools are present (knap validate, --dry-run, error-exit-1, --overwrite safety) so the destructive/batch cap does not apply, but they are presented reference-style rather than as an explicit validate→fix→retry checkpoint sequence.	4 / 5
Progressive Disclosure	Sections are clearly organized (Usage, Templates, Defuddle pipeline, Batch rendering) and deep syntax/filter/tag detail is delegated to `knap help <topic>` as a one-level-deep reference, but at ~100 lines with no file-based split there is minor room for improvement.	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.

The description is concise yet comprehensive, clearly stating the skill's purpose and providing explicit, natural trigger phrases for when to use it. It avoids vague language and over-claims entirely.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'apply a Knap template', 'turn JSON or CSV data into notes', 'batch-generate Markdown files', 'format Defuddle output into a note' — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both what ('Render Markdown from templates and structured data using Knap CLI') and when (a 'Use when...' clause with concrete trigger phrases), matching the top anchor.	5 / 5
Trigger Term Quality	Natural user phrases ('apply a Knap template', 'turn JSON or CSV data into notes', 'batch-generate Markdown files') plus format names (JSON, CSV, Markdown, Defuddle) give broad keyword coverage users would actually say.	5 / 5
Distinctiveness Conflict Risk	The Knap CLI / Markdown-template / Defuddle niche has distinct triggers and minimal overlap with other skills, so conflict risk is low.	5 / 5
	Total	20 / 20 Passed

Validation

100%

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

Validation for skill structure

No warnings or errors.

Repository: kepano/obsidian-skills
Path: skills/knap/SKILL.md
Commit: 3ccff53

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