zotero-mcp-code

Search Zotero library using code execution for efficient multi-strategy searches without crash risks. Use this skill when the user needs comprehensive Zotero searches with automatic deduplication and ranking.

Quality

50%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skill/SKILL.md

Quality

Discovery

N/A

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

Something went wrong

Implementation

50%

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

The skill provides excellent actionable code examples that are immediately executable, but suffers from severe verbosity - repeating the same 4-line import block 15+ times and over-explaining concepts Claude already understands. The structure would benefit from extracting the API reference and detailed explanations into separate files, leaving SKILL.md as a lean quick-reference with the most common patterns.

Suggestions

Define the import boilerplate once at the top and reference it (e.g., 'Use standard imports from Quick Start section') instead of repeating it in every code block

Move the API Reference, 'How It Works', and Migration sections to separate files (API.md, INTERNALS.md) and link to them

Remove explanatory sections like 'Why This Is Better' and 'Behind the Scenes' - Claude doesn't need to understand why the approach works, just how to use it

Integrate error handling into the main patterns rather than as a separate section at the end

Dimension	Reasoning	Score
Conciseness	Extremely verbose with significant redundancy. The same import boilerplate is repeated 15+ times, the 'How It Works' section explains internal mechanics Claude doesn't need, and concepts like 'why this is better' are over-explained. The document is ~400 lines when it could be ~100.	1 / 3
Actionability	Excellent executable code examples throughout. Every pattern includes complete, copy-paste ready Python code with proper imports, and the API reference provides clear parameter documentation with types and defaults.	3 / 3
Workflow Clarity	The skill is primarily single-action searches, but the error handling section is minimal and placed at the end. For a skill that mentions 'crash risks' in its description, validation and error recovery should be more prominent and integrated into the patterns.	2 / 3
Progressive Disclosure	References external files appropriately (QUICK_START.md, examples.py), but the main document itself is a monolithic wall with too much inline content. The API reference, 'How It Works', and migration guide could be separate files, with SKILL.md serving as a concise overview.	2 / 3
	Total	8 / 12 Passed

Validation

90%

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 — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (503 lines); consider splitting into references/ and linking	Warning

	Total	10 / 11 Passed

Repository: kerim/zotero-code-execution
Commit: 9d521ef

Reviewed: 3 months 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.