CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vault-skill-factory

Create a reviewable Agent Skill package from mature curated wiki pages. Use when turning verified vault knowledge into a reusable skill. Reads the vault and writes only to a review directory; it does not install skills.

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.skills/vault-skill-factory/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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-engineered, safety-conscious workflow skill: concrete commands, exact paths and defaults, an explicit confirmation checkpoint, and a closing checklist, with progressive disclosure handled by pointing to llm-wiki/SKILL.md rather than duplicating config lore. It loses top marks on optional rather than default validation, a few high-level distillation steps with no fallback when helper scripts are missing, and some deliberate-but-repetitive guardrail restatement.

Suggestions

Make structure validation a default step (run quick_validate.py when available, with a stated fallback when neither script layout exists) instead of an optional polish step.

Trim the triple restatement of the never-install guardrail — keep it once in 'Hard guardrails' and once in the checklist, and cut the repetition inside Step 5.

Concretize the remaining high-level steps, e.g. name which existing skill to use as the structural template or give a one-line example of a pushy description for the generated skill.

DimensionReasoningScore

Conciseness

The body is dense and directive with no explanation of concepts Claude already knows — every section adds ecosystem-specific facts (config vars, path layouts, maturity filters). Minor redundancy could be trimmed: the never-install/never-write-to-.skills guardrail is restated in 'Hard guardrails', Step 5, and the checklist, and some parenthetical asides (e.g. the _generated-skills naming note) run long — anchor 4, not the every-token-earns-its-place level 5, but far above the verbose examples.

4 / 5

Actionability

Highly concrete: exact env vars and defaults, a copy-paste command ('qmd query "<topic>" -c "$QMD_WIKI_COLLECTION" --files'), an exact output-directory tree, both skill-creator script-path layouts with a fallback rule, and a literal 'ln -s' install command. A few steps remain high-level ('Follow the structure of existing skills in this repo', 'Distil this from the pages' synthesis') and there is no stated fallback when neither script layout exists — anchor 4 ('mostly executable; minor gaps') rather than 5.

4 / 5

Workflow Clarity

Clear sequenced workflow (Before You Start → Steps 1–5 → report-and-stop) with an explicit user-confirmation checkpoint ('Confirm the cluster with the user before generating') and a closing quality checklist. The quick_validate.py validation is offered only as optional polish rather than a default validate-and-fix loop, which is the minor validation gap of anchor 4. The destructive/batch cap at 3 does not apply: the workflow is non-destructive by design (writes only to the review dir, never installs) and gates batch generation behind user confirmation.

4 / 5

Progressive Disclosure

There is no bundle (no references/, scripts/, or assets/), and the body is appropriately self-contained with well-organized sections. Its one deep dependency — the Config Resolution Protocol — is delegated via a clear one-level-deep pointer to 'llm-wiki/SKILL.md' instead of being duplicated, and the generated-skill layout is specified inline where it belongs. Minor organization gaps (the long guardrail prose and the Step 4 script listing could be tightened or split) hold it at anchor 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Description

75%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 description: third-person, concise, with an explicit 'Use when' clause, a concrete what, and honest scoping ('it does not install skills'). It falls just short of top marks because the trigger coverage relies on a single 'when' phrasing and omits synonyms and adjacent vocabulary users would naturally say.

Suggestions

Broaden the 'when' clause with a second trigger phrasing, e.g. 'Use when the user wants to turn vault/wiki notes, a topic cluster, or mature pages into a reusable or installable skill.'

Add natural synonyms users would say — 'Obsidian vault', 'notes', 'SKILL.md', 'skill package' — to improve trigger matching without adding length.

Mention the bundle artifacts it produces (references/ folder, provenance manifest) to sharpen the 'what' and further distinguish it from generic skill-creation helpers.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Create a reviewable Agent Skill package from mature curated wiki pages', 'Reads the vault and writes only to a review directory; it does not install skills' — so it sits at 'several specific actions; minor gaps' rather than the fully comprehensive 5 (no mention of reference folders, provenance, or validation) and clearly above the 1-2-action level 3.

4 / 5

Completeness

Explicitly answers both: what ('Create a reviewable Agent Skill package... Reads the vault and writes only to a review directory') and when ('Use when turning verified vault knowledge into a reusable skill'). The 'when' is a single phrasing without additional trigger variations, which is the anchor-4 signature ('when' could be more explicit/specific) rather than the multi-phrase concrete-trigger level 5.

4 / 5

Trigger Term Quality

Good natural keywords — 'Agent Skill', 'wiki pages', 'vault', 'reusable skill', 'install' — but coverage misses common variations a user might say ('notes', 'Obsidian', 'SKILL.md', 'make a skill'), so it matches 'good keyword coverage; a few natural terms missing' rather than the synonym- and extension-spanning level 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche — distilling curated wiki/vault pages into a skill — with the non-installing scoping adding distinctiveness, but 'wiki pages' and 'reusable skill' leave minor overlap risk with generic skill-creation or wiki-capture requests, matching 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict level 5.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

Ar9av/obsidian-wiki

Path

.skills/vault-skill-factory/SKILL.md

Reviewed

Table of Contents

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.