CtrlK
BlogDocsLog inGet started
Tessl Logo

obsidian-literature-workflow

Use this skill for project-scoped literature review built on Sources/Papers, with synthesis landing in Knowledge, writing handoff in Writing, and the default literature canvas under Maps/literature.canvas.

56

Quality

64%

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-literature-workflow/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

76%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 an exemplarily lean overview that delegates detail correctly to one-level-deep references. Its weaknesses are a never-defined evidence gate and orphaned bundle files (two scripts and two reference docs) that the overview never surfaces.

Suggestions

Define or link the evidence gate (e.g. point to references/CLAIM-EXTRACTION.md's promotion rule) and add an explicit validate-before-writing step for the batch note-generation flow.

Reference the bundled scripts (scripts/build_literature_canvas.py, build_literature_graph.py) and the unreferenced references/CANVAS-WORKFLOW.md and GRAPH-WORKFLOW.md from the body or Read-next so they are discoverable.

Add one-line labels to each Read-next entry (e.g. 'Paper notes: references/PAPER-NOTE-SCHEMA.md') so navigation is self-describing.

DimensionReasoningScore

Conciseness

The 47-line body is lean and efficient with zero padding: a one-line flow, a default-outputs list, terse rules, and a Read-next pointer list. No concept Claude already knows is explained, and every token earns its place — a clean match for anchor 5.

5 / 5

Actionability

Concrete, executable guidance is present: exact output paths ('Sources/Papers/{paper-slug}.md', 'Knowledge/Claim Map.md'), and a specific promotion contract ('Evidence Record ID, source type, claim strength, allowed wording, and forbidden stronger wording'). It falls short of anchor 5 because the bundled scripts (build_literature_canvas.py, build_literature_graph.py) are never invoked or linked, and no worked example appears inline — minor gaps rather than missing key details.

4 / 5

Workflow Clarity

The sequence exists ('Sources/Papers/ -> Knowledge/ -> Writing/ -> Maps/literature.canvas') and a checkpoint is referenced ('only after promoted claims pass the evidence gate'), but the gate itself is never defined or linked in the body, and there is no explicit validate-then-proceed step for a workflow that batch-generates notes. This matches anchor 3 — sequence present but checkpoints implicit.

3 / 5

Progressive Disclosure

The body is a genuine overview with one-level-deep references: all six Read-next files exist and (verified in CLAIM-EXTRACTION.md and others) point no deeper. It is not anchor 5 because the Read-next list is unlabeled, and several bundle files — both scripts, CANVAS-WORKFLOW.md, and GRAPH-WORKFLOW.md — are orphaned, never referenced from SKILL.md, which hurts navigation and discovery.

4 / 5

Total

16

/

20

Passed

Description

53%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.

The description communicates a clear niche and concrete vault layout, but it blends the what into a single structural sentence and never states when Claude should reach for the skill. Natural trigger vocabulary is thin, costing it both completeness and trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to review papers, build a literature synthesis, map research gaps, or write a related-work section for a project.'

Enumerate concrete actions (extract claims from papers, build method taxonomy, compile research gaps, draft related-work text) instead of describing only where outputs land.

Include natural synonyms users would say — papers, citations, related work, survey — alongside the vault-specific terminology.

DimensionReasoningScore

Specificity

Names the domain ('project-scoped literature review') and concrete destinations ('Sources/Papers', 'synthesis landing in Knowledge', 'writing handoff in Writing', 'Maps/literature.canvas'), but the actions themselves are structural and implied rather than enumerated concrete capabilities. It fits anchor 3 (domain plus 1-2 concrete actions, not comprehensive) better than anchor 4, which expects several specific actions to be listed.

3 / 5

Completeness

The 'what' is clear (project-scoped literature review with a defined vault flow), but 'when' has no explicit trigger guidance: 'Use this skill for...' restates the what rather than naming conditions under which to invoke it. Per the judging guidelines, a missing explicit 'Use when...' clause caps completeness at 3.

3 / 5

Trigger Term Quality

'literature review', 'synthesis', and 'literature canvas' are natural terms, but common variations users would actually say — 'papers', 'citations', 'related work', 'survey', 'reading notes' — are missing. This matches 'some relevant keywords but missing common variations or synonyms' rather than anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

'Project-scoped literature review' anchored to Obsidian-specific vault paths (Sources/Papers, Knowledge, Writing, Maps/literature.canvas) carves a fairly clear niche with only minor overlap risk against generic literature-review or note-taking skills — matching anchor 4 rather than anchor 5, since the trigger phrasing itself is not uniquely distinctive.

4 / 5

Total

13

/

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
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.