zotero-obsidian-bridge

Use this skill when Zotero is the literature source of truth and the project KB should receive source notes under Sources/Papers plus project-linked synthesis in Knowledge and Writing.

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/zotero-obsidian-bridge/SKILL.md

Quality

Content

65%

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 and free of concept-padding with a useful Evidence Record template, but it acts as a standalone rule sheet rather than an overview that points into the well-organized bundle. The detailed workflow, schemas, fallback, and verification script are never referenced, and one cross-skill link is broken.

Suggestions

Add a short 'References' section linking the existing bundle files (references/WORKFLOW.md, PAPER-NOTE-SCHEMA.md, COLLECTION-INVENTORY-SCHEMA.md, LOCAL-ZOTERO-FALLBACK.md) and scripts/verify_paper_notes.py so the body navigates into them.

Surface the verification step and the verify_paper_notes.py command inline (or via a clear link) so the batch-ingestion workflow has an explicit validation checkpoint.

Fix or remove the broken reference to ../research-ideation/references/research-contract.md, which does not resolve from this skill's directory.

Dimension	Reasoning	Score
Conciseness	The ~44-line body is lean, assumes Claude knows what Zotero/Obsidian are, avoids concept padding, and every section (rules, Evidence Record template, Claim Promotion Gate) earns its place, matching anchor 3.	3 / 3
Actionability	Concrete paths and a copy-paste Evidence Record template are present, but the step-by-step procedure and the verification command live in references/WORKFLOW.md, which the body never links, leaving key details incomplete per anchor 2.	2 / 3
Workflow Clarity	The default-flow diagram supplies a sequence and the Claim Promotion Gate is a checkpoint, but the explicit verification step and command for this batch-ingestion workflow are absent from the body; the batch-operations guideline caps this at 2.	2 / 3
Progressive Disclosure	The bundle is well-structured (WORKFLOW.md, PAPER-NOTE-SCHEMA.md, COLLECTION-INVENTORY-SCHEMA.md, LOCAL-ZOTERO-FALLBACK.md, verify_paper_notes.py), but the body does not signal or navigate to any of them, and its one cross-skill reference (../research-ideation/references/research-contract.md) does not exist; not a monolithic wall, so anchor 2 rather than 1.	2 / 3
	Total	9 / 12 Passed

Description

75%

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 clearly states a distinct Zotero-to-KB niche with an explicit trigger clause and named destinations. It is somewhat light on enumerating concrete actions and on common trigger-term variations, which keeps specificity and trigger quality at the mid level.

Suggestions

Add one or two concrete actions (e.g., 'ingest paper notes', 'synthesize literature', 'rebuild the literature canvas') to lift specificity from 2 to 3.

Include natural trigger variations users would say ('Obsidian', 'papers', 'PDFs', 'citations', 'annotations') alongside 'Zotero' and 'literature'.

Dimension	Reasoning	Score
Specificity	Names the domain and concrete destinations ('Sources/Papers', 'Knowledge', 'Writing') but does not list a comprehensive set of specific concrete actions, matching anchor 2 rather than 3.	2 / 3
Completeness	The explicit 'Use this skill when...' clause answers when, and routing source notes plus project-linked synthesis to named KB locations answers what; the trigger clause is present so it is not capped at 2.	3 / 3
Trigger Term Quality	'Zotero', 'literature', and 'synthesis' are natural terms a user would say, but common variations such as 'Obsidian', 'papers', 'PDFs', and 'citations' are missing, so it lands at anchor 2 rather than full coverage at 3.	2 / 3
Distinctiveness Conflict Risk	The Zotero-as-literature-source-of-truth framing carves a clear niche with distinct triggers unlikely to fire for unrelated skills, matching anchor 3.	3 / 3
	Total	10 / 12 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: Galaxy-Dawn/claude-scholar
Path: skills/zotero-obsidian-bridge/SKILL.md
Commit: 2f7766f

Reviewed: about 12 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.