CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vault-ingest

One-shot ingestion of an external source (URL, file, zip, PDF) into the second-brain Obsidian vault at ~/Vaults/second-brain. Wraps source resolution, mandatory security review (prompt-injection, secrets, PII), focused extraction against a user-specified lens, and the existing Vault Ingestion Contract write pipeline. Trigger when the user drops a URL/path with "ingest this into the vault", asks to add a source/article/discovery doc to the vault with a specific focus, or types `/vault-ingest`.

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 exceptionally actionable, well-sequenced operational skill — every phase has executable commands, explicit checkpoints, and failure handling. Its weaknesses are a monolithic single-file structure with no bundled reference files (despite referencing an unbundled calibration script) and rationale/backstory sections that inflate token cost without aiding execution.

Suggestions

Move the prompt-injection, secrets, and PII regex pattern libraries (~50 lines) into references/security-patterns.md and read them only during Phase 2, keeping SKILL.md as a lean phase-by-phase overview.

Trim the 'What this skill is for' backstory and Phase 0.5's academic-citation framing to one or two sentences each — the model needs the calibration mechanics, not the pattern's provenance.

Bundle generate-calibration.py (and a generated calibration.md sample) in scripts/ alongside SKILL.md so the referenced files actually resolve within the skill distribution.

DimensionReasoningScore

Conciseness

The bulk is dense operational payload (commands, regexes, templates), but it includes unnecessary explanation and rationale that could be trimmed: the "What this skill is for" backstory ("You've run it 5+ times manually — same shape every time"), the threat-model explainer ("the source is untrusted text being read by an LLM that has filesystem and shell access"), and Phase 0.5's academic citations ([[Filesystem-as-Feedback for Coding Agents]], [[Meta-Harness Paper (Lee et al, 2026)]]) which explain concepts the model already grasps. This is more than the 'minor instances' of the anchor-4 example but far from the padding of anchor 2.

3 / 5

Actionability

Fully executable throughout: copy-paste-ready defuddle/unzip/git command blocks, complete prompt-injection and secrets regex libraries (e.g. "AKIA[0-9A-Z]{16}", "ghp_[A-Za-z0-9]{36}"), a gitleaks fallback, and exact fill-in templates for the Phase 4 write plan, security summary, and Phase 6 report. Specific commands cover the common source types (URL, PDF, local file, directory, zip).

5 / 5

Workflow Clarity

Six phases are explicitly ordered ("Follow these phases in order. Do not skip phases") with validation checkpoints at every risky stage: mandatory security stop-and-wait ("If any HIGH-severity finding exists, stop and wait"), the Phase 4 checkpoint ("**Wait for the user.** Do not write anything until they say go"), a pre-write concurrent-write check (git fetch/status with behind/diverged handling), and failure handling ("If any step fails: **stop and report.** Do not partial-recover"). Feedback loops are explicit ("If they say 'edit plan', revise and re-show") and the Honesty rules act as a final checklist — a textbook anchor-5 workflow.

5 / 5

Progressive Disclosure

The body is a monolithic ~360-line SKILL.md with no bundle files at all — no references/, scripts/, or assets/ — yet it references "~/.claude/skills/vault-ingest/generate-calibration.py" and "calibration.md" which are not part of the bundle. Content that clearly belongs in separate files is inlined (~50 lines of injection/secrets/PII regex libraries, full write-plan templates). Mitigating factors keep it at 3 rather than 2: sections are well-organized with clear headers, and references to the vault's own docs (Phase 0's CLAUDE.md / Vault Ingestion Contract / jobs files) are clearly signaled and one level deep.

3 / 5

Total

16

/

20

Passed

Description

87%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 explicitly covers what the skill does, when to use it with concrete quoted trigger phrases, and a clearly bounded niche. The only notable gap is that the write pipeline stage is referenced by name (the Vault Ingestion Contract) rather than summarized concretely.

DimensionReasoningScore

Specificity

"Wraps source resolution, mandatory security review (prompt-injection, secrets, PII), focused extraction against a user-specified lens, and the existing Vault Ingestion Contract write pipeline" lists several concrete, specific actions. It falls short of 5 because the write stage is named only as a reference to an external contract rather than described in concrete terms (concepts, entities, MOC wiring, commit are absent from the description).

4 / 5

Completeness

Both questions are answered explicitly: the what ("One-shot ingestion of an external source (URL, file, zip, PDF) into the second-brain Obsidian vault at ~/Vaults/second-brain") and the when ("Trigger when the user drops a URL/path with 'ingest this into the vault'...") with concrete trigger phrases. This matches the anchor-5 example structure exactly; a 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Natural trigger phrases are present and quoted directly — "ingest this into the vault", "asks to add a source/article/discovery doc to the vault with a specific focus", "or types /vault-ingest" — with synonyms (source/article/discovery doc). A few natural variants (e.g. "save to my notes", "add to my vault") and file extensions (.pdf, .zip) are missing, so it does not reach comprehensive 5-level coverage.

4 / 5

Distinctiveness Conflict Risk

The description pins a clear niche — ingestion into one specific vault ("the second-brain Obsidian vault at ~/Vaults/second-brain") — with trigger phrases unique to that action ("ingest this into the vault", "/vault-ingest"). Conflict risk with any other skill is minimal; it is not merely 'mostly distinct' as the anchor-4 example requires.

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/vault-ingest/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.