CtrlK
BlogDocsLog inGet started
Tessl Logo

obsidian-source-ingestion

Use this skill to ingest external materials into the current project-scoped Obsidian KB as source notes under Sources/Papers, Sources/Web, Sources/Docs, Sources/Data, Sources/Interviews, or Sources/Notes.

65

Quality

77%

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/obsidian-source-ingestion/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

87%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is concise, actionable, and well-structured with verified one-level-deep references. Its main gap is workflow clarity: the rules read as a checklist rather than an ordered, validated sequence.

Suggestions

Convert 'Core rules' into an ordered step list (pick source type/folder -> create note -> update `_system/registry.md` -> conditionally update `02-Index.md` -> conditionally log in `Daily/`) so the sequence is explicit.

Add a verification checkpoint, e.g. confirm the new note is linked from `_system/registry.md` and that no top-level `Papers/` was created, before finishing.

Clarify what 'important sources' means for the `02-Index.md` update rule, since that qualifier is currently subjective.

DimensionReasoningScore

Conciseness

The body is lean: it assumes Claude knows what Obsidian and source notes are, states only essential rules and targets, and contains no padding or restated concepts, matching the lean-and-efficient anchor.

3 / 3

Actionability

It gives concrete, named actions — update `_system/registry.md`, update `02-Index.md`, append to today's `Daily/`, and avoid a top-level `Papers/` — which are specific and actionable for an instruction-only skill where code absence is not penalized.

3 / 3

Workflow Clarity

The core rules imply a sequence (create note, update registry, update index, log in Daily) but are not ordered as steps and lack any validation/verification checkpoint, fitting the sequence-present-but-checkpoints-implicit anchor.

2 / 3

Progressive Disclosure

The body is a concise overview with a clearly signaled 'Read next' section pointing one level deep to five reference files, all of which exist in references/, matching the clear-overview-with-one-level-deep-references anchor.

3 / 3

Total

11

/

12

Passed

Description

67%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific and well-scoped to a clear niche, but it describes the action rather than giving an explicit 'Use when...' trigger, and its keywords are somewhat jargon-heavy. Adding a when-clause and more natural user phrasing would lift completeness and trigger-term quality.

Suggestions

Append an explicit trigger clause, e.g. 'Use when external material (a paper, web page, doc, dataset, interview, or note) should become a project-local Obsidian source note.'

Soften jargon and add natural variations users would say, such as 'add to vault', 'save as source note', or 'clip this page/article'.

Reconsider the long enumeration of all six Sources/ subfolders in the description; naming the category once may read more naturally while keeping specificity.

DimensionReasoningScore

Specificity

It names a concrete action ('ingest external materials ... as source notes') and enumerates six specific destination paths (Sources/Papers, Sources/Web, Sources/Docs, Sources/Data, Sources/Interviews, Sources/Notes), matching the multiple-specific-concrete-actions anchor rather than the single-domain anchor at 2.

3 / 3

Completeness

The 'what' is explicit ('ingest external materials ... as source notes under ...') but the only trigger phrasing is 'Use this skill to', which states the action rather than when to use it; per the guidelines a missing 'Use when...' clause caps completeness at 2.

2 / 3

Trigger Term Quality

It includes relevant keywords ('ingest', 'source notes', 'Obsidian KB') but leans on jargon ('project-scoped Obsidian KB') and omits common user variations like 'add to my vault', 'save this paper', or 'clip this page', fitting the some-relevant-keywords-but-missing-variations anchor.

2 / 3

Distinctiveness Conflict Risk

The niche is tightly scoped to project-scoped Obsidian source notes under Sources/*, with branded terms and concrete folder paths that make it unlikely to trigger for an unrelated skill.

3 / 3

Total

10

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Galaxy-Dawn/claude-scholar
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.