CtrlK
BlogDocsLog inGet started
Tessl Logo

abstract-summarizer

Transform lengthy academic papers into concise, structured 250-word abstracts.

50

Quality

55%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Academic Writing/abstract-summarizer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%

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

The skill body contains valuable domain-specific content and concrete examples, but it is padded with generic templated boilerplate, references script and reference files that do not exist in the bundle, and documents CLI flags inconsistently with its parameter table. Tightening the boilerplate and aligning the file references with the actual bundle would substantially improve quality.

Suggestions

Remove or condense the generic templated sections (When to Use, Implementation Details, Input Validation, Response Template, Output Requirements) that restate the description or teach concepts Claude already knows.

Reconcile the References and Scripts listings with the actual bundle: point to the real references/abstract-templates.md, references/evaluation-rubric.md, and references/example-abstracts/ files, and only document scripts/main.py.

Make code examples executable by removing imports of non-existent modules (scripts.summarizer, scripts.batch) or by adding those modules, and align the documented CLI flags with the Parameters table.

DimensionReasoningScore

Conciseness

The body mixes genuine domain content (Core Capabilities, Quality Checklist, Common Pitfalls) with large tracts of generic templated boilerplate ('When to Use', 'Implementation Details', 'Input Validation', 'Response Template', 'Output Requirements') that restate the description and teach concepts Claude already knows. It is not a 3 because of this padding and duplication, and not a 1 because substantial actionable content is still present.

2 / 3

Actionability

It provides concrete code examples and CLI commands, but the Python examples import modules that do not exist in the bundle (e.g., 'from scripts.summarizer import AbstractSummarizer', 'from scripts.batch import BatchProcessor') and the CLI examples use a '--field' flag absent from the Parameters table. It is not a 3 because the examples are not reliably copy-paste executable, and not a 1 because concrete, specific guidance is clearly provided.

2 / 3

Workflow Clarity

A 'Workflow' section and validation checkpoints exist (py_compile Quick Check, pre/during/post Quality Checklist), but the main Workflow steps are generic boilerplate ('Confirm the user objective', 'Validate that the request matches the documented scope') rather than a task-specific extract-structure-verify sequence, and accuracy verification is exposed as a function rather than an explicit validate-fix-retry loop. It is not a 3 because checkpoints are implicit and the workflow is not domain-specific, and not a 1 because steps and some validation are present.

2 / 3

Progressive Disclosure

The body has clear section structure and a real references/ directory, but its 'References' and 'Scripts' sections list files that do not exist in the bundle (e.g., quantitative_checklist.md, disciplinary_guidelines.md, summarizer.py, batch_processor.py) and misname real ones (abstract_templates.md vs the actual abstract-templates.md). It is not a 3 because navigation is broken by incorrect file names, and not a 1 because the content is sectioned and references are only one level deep rather than deeply nested.

2 / 3

Total

8

/

12

Passed

Description

60%

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 about the input and the structured 250-word output format, but it lacks any 'Use when...' trigger guidance, which caps completeness and leaves some overlap risk with general summarization skills. Adding explicit trigger terms like 'summarize', 'research papers', or 'literature review' would raise both completeness and trigger-term quality.

Suggestions

Add an explicit 'Use when...' clause naming natural triggers (e.g., 'Use when summarizing research papers, writing abstracts, or condensing literature for a 250-word limit').

Include common user phrasings like 'summarize', 'research papers', and 'literature review' alongside 'academic papers' and 'abstracts' to improve trigger-term coverage.

DimensionReasoningScore

Specificity

Phrases like 'Transform lengthy academic papers into concise, structured 250-word abstracts' name a concrete input (academic papers), action (transform), and a specific output constraint (structured 250-word abstracts), matching the 'lists multiple specific concrete actions' anchor. It is not a 2 because it goes beyond naming only a domain and some actions by including a precise output format constraint.

3 / 3

Completeness

The description states what the skill does but has no 'Use when...' clause or equivalent explicit trigger guidance, so per the judging guidelines completeness is capped at 2. It is not a 3 because the 'when' is entirely missing, and not a 1 because the 'what' is clearly stated.

2 / 3

Trigger Term Quality

It includes relevant natural terms such as 'academic papers' and 'abstracts', but omits common variations a user would say like 'summarize', 'research papers', or 'literature'. It is not a 3 because keyword coverage is incomplete, and not a 1 because the terms present are natural rather than jargon.

2 / 3

Distinctiveness Conflict Risk

'structured 250-word abstracts' targets a fairly clear niche, but without explicit trigger guidance it could still overlap with general summarization skills. It is not a 3 because the absence of distinct triggers leaves overlap risk, and not a 1 because the domain is not generic.

2 / 3

Total

9

/

12

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.

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