CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

para-vault

Use this skill when the user asks to "file this note into PARA", "process vault inbox", "organize my PARA vault", "reconcile vault documents", "propose note revision", "archive this project", "reactivate archived note", "check vault navigation", "repair broken MOC links", or "import calendar/email records into vault". Covers the full PARA knowledge lifecycle (Projects, Areas, Resources, Archives). Do NOT use this skill for raw filesystem moves outside a PARA vault (use `manage-file-operations`) or drafting user communications (use `write-like-me`).

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.hermes/plugins/agent-skills/skills/para-vault/SKILL.md

The canonical home for this skill is para-vault in NyssaAI/agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

53%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 body is a well-structured, concise orchestrator facade with genuine invariants and a concrete verification checklist, but its navigation is fundamentally broken: every workflow link points to a nonexistent `workflows/` directory while nearly all real reference files are orphaned. As written, Claude following the triage matrix would hit dead paths and be unable to reach the detailed guidance the bundle actually contains.

Suggestions

Fix the broken navigation: either create the five `workflows/*.md` runbooks or re-point the architecture diagram, triage matrix, and verification section at the existing `references/*.md` files (e.g. `workflows/file.md` → `references/classification.md` + `references/folder-conventions.md`, `workflows/reconcile.md` → `references/revisions.md`, `workflows/archive.md` → `references/lifecycle.md`, `workflows/navigate.md` → `references/navigation.md`, `workflows/import-records.md` → `references/source-records.md`).

Link the seven currently orphaned reference files from SKILL.md so the bundle's detailed guidance is discoverable, and add a verification item that wikilink/relative-link targets actually resolve before reporting completion.

Trim redundancy to earn back token efficiency: the Scope Directive callout duplicates the frontmatter's negative-scope statement, and the ASCII architecture diagram repeats the triage matrix's intent-to-runbook mapping.

DimensionReasoningScore

Conciseness

The body is lean — a compact lifecycle diagram, a routing table, four one-line invariants, and a short checklist, with no teaching of concepts Claude already knows. Minor trims remain: the Scope Directive callout repeats the frontmatter's negative scope, and the ASCII diagram duplicates the triage matrix's routing information, keeping it below anchor 5.

4 / 5

Actionability

Concrete elements exist (strict four-category evaluation order, native-payload preservation rule, verification checklist with specific items like "bit-for-bit identical" and lifecycle fields), but the primary executable guidance routes to `workflows/file.md`, `workflows/reconcile.md`, `workflows/archive.md`, `workflows/navigate.md`, and `workflows/import-records.md` — none of which exist in the bundle, and the detailed `references/*.md` files that do exist are not linked. This matches 'some concrete guidance but incomplete; missing key details' rather than anchor 4's mostly-executable guidance.

3 / 5

Workflow Clarity

The lifecycle is sequenced (ingestion → maintenance → transitions), classification order is strict (Projects → Areas → Resources → Archives), and the Verification section supplies pre-completion checkpoints, so the destructive-operation cap is not triggered. However, the actual operational steps are delegated to the five nonexistent `workflows/*.md` files and there is no error-recovery loop, leaving sequence gaps that exceed anchor 4's 'minor validation gaps'.

3 / 5

Progressive Disclosure

Scored against the actual bundle: the entry point's central navigation (architecture diagram and triage matrix) targets `workflows/*.md` paths that do not exist, and 7 of the 8 well-scoped files in `references/` (classification, folder-conventions, lifecycle, navigation, revisions, source-records, vault-conventions) are never referenced from SKILL.md — only `references/frontmatter-schemas.md` is linked. The bulk of bundle content is therefore effectively buried behind dead links, matching anchor 2 ('references are buried') rather than anchor 3, though SKILL.md itself is well-sectioned rather than a monolithic wall.

2 / 5

Total

12

/

20

Passed

Description

86%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 trigger-focused description with comprehensive natural phrasing, explicit when-to-use and when-not-to-use guidance, and good disambiguation from adjacent skills. Its main weakness is that the 'what' is conveyed indirectly through quoted user intents plus a generic lifecycle statement, rather than a declarative list of the skill's capabilities.

DimensionReasoningScore

Specificity

The description enumerates many concrete operations via natural quoted phrases ("file this note into PARA", "archive this project", "repair broken MOC links", "import calendar/email records into vault") plus the four PARA categories. It stays below 5 because the declarative 'what' statement ("Covers the full PARA knowledge lifecycle") is generic rather than a list of the skill's own capabilities.

4 / 5

Completeness

The 'when' is emphatically explicit with concrete trigger phrases and negative triggers ("Do NOT use this skill for raw filesystem moves..."), and a 'what' is present ("Covers the full PARA knowledge lifecycle (Projects, Areas, Resources, Archives)"). Not 5 because the 'what' leans on the domain statement rather than clearly stating in third person what the skill does; not 3 because the 'when' is far from missing or weakly implied.

4 / 5

Trigger Term Quality

Ten natural user phrasings span every lifecycle stage ("process vault inbox", "reconcile vault documents", "reactivate archived note", "organize my PARA vault"), giving comprehensive coverage including synonyms. It clearly exceeds anchor 4 ("a few natural terms missing") — no common PARA/vault phrasing is obviously absent.

5 / 5

Distinctiveness Conflict Risk

A clear niche (PARA vault management) with distinct triggers, and explicit delegation instructions for adjacent skills ("use `manage-file-operations`", "use `write-like-me`") actively reduce conflict risk. This matches the anchor-5 example's pattern of a distinct niche with minimal conflict.

5 / 5

Total

18

/

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

relative_links

Relative link issues: 5 missing

Warning

Total

15

/

16

Passed

Repository

NyssaAI/agent-skills

Path

.hermes/plugins/agent-skills/skills/para-vault/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.