vault-capture

Captures an important insight, decision, constraint, pattern, or discovery to persistent memory via the vault CLI — distinct from general note-taking in that entries are tagged, tiered, and retrievable across future sessions. Use when the user says "save this", "remember this", "note for later", "don't forget", or "keep this in mind", or when the conversation produces something worth preserving: architectural decisions, recurring bugs, hard-won constraints, naming conventions, or user preferences.

Quality

88%

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

86%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 tight, highly actionable single-purpose skill: complete command syntax, a clear tier decision procedure, and realistic examples with guardrails in the Never section. The only issues are minor — the tier-selection logic is presented twice with slightly different framing, and the quoting rule is stated in two places.

Suggestions

Merge the Mindset two-question flow and the Tier selection table into one decision procedure so the default tier is stated consistently (the flow implies 'else → semantic' while the table says episodic is the default).

State the shell-quoting rule once — either in 'How to use' or in the Never section — instead of repeating it in both.

Dimension	Reasoning	Score
Conciseness	Lean with no explanations of concepts Claude already knows, but the Mindset two-question flow and the Tier selection table duplicate the same tier decision, and the shell-quoting rule appears in both 'How to use' and 'Never', giving minor trimmable redundancy rather than the every-token-earns-its-place quality of anchor 5.	4 / 5
Actionability	Fully executable guidance: the complete 'vault-cli capture' command with all flags, a stdin pipe variant, and three copy-paste-ready examples covering semantic, procedural, and episodic cases with realistic tags and projects.	5 / 5
Workflow Clarity	The single action is unambiguous and the two-question decision sequence is clear, but there is a minor consistency gap: the Mindset flow implies 'else → semantic' while the Tier selection table marks 'episodic' as the default, leaving the fallback tier slightly ambiguous — not a validation gap since capture is neither destructive nor batch.	4 / 5
Progressive Disclosure	A compact, single-file skill with no bundle files and no content that belongs in separate files; sections (Mindset, When to use, How to use, Tier selection, Examples, Never) are well-organized and easy to navigate, satisfying the simple-skill exception.	5 / 5
	Total	18 / 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.

A strong description that clearly states what the skill does, via which tool, and when to use it, with unusually good natural-language trigger phrases and an explicit differentiator from general note-taking. The only weakness is minor trigger overlap risk with other memory-style skills from generic phrases like 'save this'.

Dimension	Reasoning	Score
Specificity	Names the tool and several concrete capabilities — 'Captures an important insight, decision, constraint, pattern, or discovery to persistent memory via the vault CLI' with 'tagged, tiered, and retrievable' — which goes beyond the 1-2 actions of anchor 3, though it is a single-purpose skill without the multi-action comprehensiveness of anchor 5.	4 / 5
Completeness	Explicitly answers both what (capture to persistent vault memory with tagging, tiering, and cross-session retrieval) and when ("Use when the user says..." with concrete quoted trigger phrases), matching the anchor-5 structure exactly.	5 / 5
Trigger Term Quality	Comprehensive natural trigger phrases — '"save this", "remember this", "note for later", "don't forget", "keep this in mind"' — plus concrete content categories ('architectural decisions, recurring bugs, hard-won constraints, naming conventions, user preferences'), giving full synonym-level coverage users would actually say.	5 / 5
Distinctiveness Conflict Risk	The clause 'distinct from general note-taking in that entries are tagged, tiered, and retrievable' explicitly disambiguates and the vault CLI niche is clear, but generic memory phrases like 'save this' and 'keep this in mind' carry minor overlap risk with other memory or note-taking skills.	4 / 5
	Total	18 / 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: pantheon-org/tekhne
Path: skills/agentic-harness/vault-capture/SKILL.md
Commit: a1083f4

Reviewed: 3 hours 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.