CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vault-memory-workflow

Commands, architecture conventions, known gotchas, and testing patterns for working in the vault-memory Python daemon repository (FastAPI + Click + Postgres/Weaviate, pytest with mocked heavy deps).

Quality

83%

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

SKILL.md
Quality
Evals
Security

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.

An exemplary repo-workflow skill: dense, non-obvious, copy-paste-ready knowledge with zero padding and a clear result-interpretation checkpoint for tests. The only structural lever is that the detailed testing recipes sit inline in an already-full SKILL.md and could move to a reference file if the skill grows.

DimensionReasoningScore

Conciseness

Every line is repo-specific, non-inferable knowledge: exact commands, file paths, function names, and gotchas ("init_db.sql uses id as PK for sessions, not session_id"). There is no explanation of concepts Claude already knows, and the dense bullet style matches the 'lean and efficient; every token earns its place' anchor. Not 4 because no section could be trimmed without losing non-obvious information.

5 / 5

Actionability

Commands are copy-paste ready ("pytest tests/ -q --basetemp .pytest_tmp", "python3 -m py_compile daemon/main.py cli/mcp_adapter.py"), and the testing patterns give exact idioms with real identifiers ("MagicMock(spec=Dependencies)", "app.dependency_overrides[get_dependencies] = lambda: deps", "asyncio.run(handler(req, deps=deps, _auth=None))"). This matches the fully-executable anchor with specific examples covering the common cases; no gaps found, so it does not fall to 4.

5 / 5

Workflow Clarity

The Commands section sequences quick syntax check → full suite → targeted run, and includes a result-interpretation checkpoint ("'passed + skipped' = green" with expected ~7 skips), matching 'clear sequence with most checkpoints present'. Not 5 because the edit→verify loop is implicit rather than an explicit validate-and-recover workflow (no 'if tests fail, do X' guidance); not 3 because validation checkpoints are present, not absent, and no destructive/batch cap applies.

4 / 5

Progressive Disclosure

The single SKILL.md is well organized into Commands / Architecture conventions / Gotchas / Testing patterns with no nested references at all (no references/, scripts/, or assets/ bundle exists), matching 'good structure; most content appropriately placed'. Not 5 because at ~70 body lines it exceeds the under-50-line simple-skill exception, and the detailed Testing patterns section is the one candidate that could split into a reference file; not 3 because there is no misplaced inline bulk and navigation is easy.

4 / 5

Total

18

/

20

Passed

Description

70%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 highly distinctive, stack-specific description that clearly communicates what the skill provides, but it lacks any explicit 'use when' trigger guidance, which caps completeness. Adding a trigger clause naming the natural contexts (working in the vault-memory repo, running its tests) would raise it substantially.

Suggestions

Add an explicit trigger clause, e.g., 'Use when working in or making changes to the vault-memory repository, running its test suite, or modifying its FastAPI routes/CLI.'

Frame capabilities as concrete actions rather than content inventory (e.g., 'Run and target the pytest suite, follow DI/route conventions, avoid known gotchas') to sharpen specificity.

Include a couple of natural synonyms users might say (Obsidian vault, semantic memory, Lite Mode) to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description lists several concrete content categories — "Commands, architecture conventions, known gotchas, and testing patterns" — and pins them to a specific stack ("FastAPI + Click + Postgres/Weaviate, pytest with mocked heavy deps"), matching the anchor for several specific actions with minor gaps. It falls short of 5 because it describes what the skill contains rather than enumerating the concrete actions it enables (e.g., running tests, navigating the DI container), and short of 3 because the 'what' is far more detailed than 1-2 generic actions.

4 / 5

Completeness

The 'what' is clear and detailed (commands, conventions, gotchas, testing patterns), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the 'when' is only weakly implied by "for working in the vault-memory Python daemon repository", which the rubric explicitly caps at 3. Not 4 because the cap rule takes precedence over the weak implication; not 2 because the 'what' half is fully present.

3 / 5

Trigger Term Quality

Strong natural keywords a developer in this repo would say: "vault-memory", "Python daemon repository", "FastAPI", "Click", "Postgres/Weaviate", "pytest" — good coverage per the anchor. Not 5 because a few natural synonyms are missing ("Obsidian", "vault", "CLI", " Lite Mode"); not 3 because the terms go beyond merely 'some relevant keywords' and include the stack names users actually mention.

4 / 5

Distinctiveness Conflict Risk

It names a specific repository and a distinctive stack (vault-memory, FastAPI + Click + Postgres/Weaviate), giving it a clear niche with minimal overlap risk against other skills. It clearly matches the 5 anchor (clear niche with distinct triggers) and does not fall to 4, since no closely related generic skill would plausibly collide with these triggers.

5 / 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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

pvnkmnk/vault-memory

Path

.agents/skills/vault-memory-workflow/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.