CtrlK
BlogDocsLog inGet started
Tessl Logo

anki-card-creator

Use anki-card-creator for academic writing workflows that need structured execution, explicit assumptions, and clear output boundaries for study-card generation.

39

Quality

37%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./scientific-skills/Academic Writing/anki-card-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

40%

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 heavy on abstract process language ('structured execution', 'explicit assumptions', 'clear output boundaries') but fails to describe what the skill actually does in concrete terms. It lacks specific actions like creating flashcards, generating Q&A pairs, or formatting Anki-compatible output, and misses many natural trigger terms users would employ when seeking this functionality.

Suggestions

Replace abstract language with concrete actions, e.g., 'Creates Anki-compatible flashcards from academic content, generates Q&A pairs, and formats cards for spaced repetition study.'

Add natural trigger terms users would say: 'flashcards', 'Anki deck', 'spaced repetition', 'study cards', 'memorization', '.apkg'.

Strengthen the 'when' clause with specific scenarios: 'Use when the user wants to create flashcards, build an Anki deck, or convert notes/textbook content into study cards.'

DimensionReasoningScore

Specificity

The description uses vague, abstract language like 'structured execution', 'explicit assumptions', and 'clear output boundaries' without listing any concrete actions. It doesn't specify what the skill actually does (e.g., create flashcards, extract key terms, generate Q&A pairs).

1 / 3

Completeness

It has a 'Use when' clause ('Use anki-card-creator for academic writing workflows...'), but the 'what' is extremely weak — it never explains what the skill concretely does. The 'when' is also vague, describing abstract qualities rather than concrete scenarios.

2 / 3

Trigger Term Quality

Contains some relevant keywords like 'anki', 'study-card', and 'academic writing', but misses common natural terms users would say such as 'flashcards', 'Anki deck', 'spaced repetition', 'study notes', or 'memorization'.

2 / 3

Distinctiveness Conflict Risk

The mention of 'anki' and 'study-card generation' provides some distinctiveness, but 'academic writing workflows' is broad enough to overlap with general writing or academic assistance skills.

2 / 3

Total

7

/

12

Passed

Implementation

35%

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

This skill is significantly over-engineered for its purpose. It repeats the same commands and concepts across multiple sections (Quick Check, Audit-Ready Commands, Example Usage all contain the same py_compile command), includes boilerplate sections like Risk Assessment and Security Checklist that add little actionable value, and lacks the most important thing: a complete input-to-output example showing actual card generation. The structure prioritizes audit compliance over usability.

Suggestions

Cut the file by at least 60%: remove duplicate sections (Quick Check vs Audit-Ready Commands vs Example Usage), the Risk Assessment table, Security Checklist, Lifecycle Status, and Response Template—these are boilerplate that Claude doesn't need.

Add a complete end-to-end example showing real input text, the exact command to run, and the expected TSV output so Claude can see the full card generation pipeline.

Consolidate the workflow into a single authoritative sequence instead of splitting it across 'Example Usage run plan', 'Workflow', and 'Implementation Details' sections.

Move the parameter table and detailed error handling into a referenced file (e.g., REFERENCE.md) to keep SKILL.md as a concise overview.

DimensionReasoningScore

Conciseness

Extremely verbose and repetitive. Multiple sections restate the same information (e.g., 'python -m py_compile scripts/main.py' appears 3 times, workflow steps are repeated across sections). Contains self-referential loops like 'See ## Prerequisites above for related details' and 'See ## Workflow above for related details'. The Risk Assessment, Security Checklist, Lifecycle Status, and Response Template sections add significant bulk with minimal actionable value for Claude. Much of this content explains things Claude already knows (error handling principles, input validation concepts).

1 / 3

Actionability

Provides concrete CLI commands and a parameter table, which is useful. However, the actual card generation workflow is vague—the 'Example' section shows only a single Q line with no expected output. The 'Example Usage' section shows how to run the script but not how to actually generate cards with real inputs and expected outputs. Missing a complete end-to-end example with input data and resulting TSV output.

2 / 3

Workflow Clarity

The Workflow section provides a reasonable 5-step sequence with a fallback for missing content (step 5). However, validation checkpoints are weak—there's no explicit 'validate the output TSV format' step, and the feedback loop for errors is buried in a separate Error Handling section rather than integrated into the workflow. The 'Example run plan' in Example Usage partially duplicates the Workflow section with slightly different steps, creating confusion about which sequence to follow.

2 / 3

Progressive Disclosure

References 'references/audit-reference.md' and 'scripts/main.py' but no bundle files are provided to verify these exist. The skill itself is monolithic—content that could be in separate files (Risk Assessment, Security Checklist, full parameter table) is inline, making the SKILL.md very long. The single reference to audit-reference.md is appropriate but the overall structure would benefit from splitting detailed content into referenced files.

2 / 3

Total

7

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
aipoch/medical-research-skills
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.