CtrlK
BlogDocsLog inGet started
Tessl Logo

abstract-summarizer

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

44

Quality

56%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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

38%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 contains real skill value (structured output format, accuracy checklists, pitfalls, field-specific handling) but is buried in generic boilerplate, duplicated sections, and — most damaging — documentation that does not match the shipped bundle: five of six scripts and all five named reference files are absent, and the Python examples import non-existent modules. The document as written would actively mislead execution.

Suggestions

Fix the References and Scripts listings to match the actual bundle (`abstract-templates.md`, `evaluation-rubric.md`, `example-abstracts/cs-and-biomed-examples.md`, `scripts/main.py`), removing entries for files that do not exist.

Replace the non-executable Python examples (imports of `scripts.summarizer`/`scripts.batch`) with real invocations of `scripts/main.py`, and correct the Parameters table to reflect the actual CLI (--input/--text/--url are mutually optional inputs, --output and --format optional, --field non-existent).

Cut the generic boilerplate (Key Features, Implementation Details, Output Requirements, Input Validation, Response Template) and merge the duplicated Overview/Core Capabilities sections to roughly halve token load while keeping the checklists and pitfalls table.

DimensionReasoningScore

Conciseness

The ~290-line body is noticeably verbose: generic boilerplate sections Claude already knows ("Key Features", "Implementation Details", "Output Requirements", "Input Validation", "Response Template") are heavily padded, overview content is duplicated between "Overview/Key Capabilities" and "Core Capabilities", and "See `## Workflow` above for related details" is a broken forward reference placed before the Workflow section. It is not 1 because genuine skill-specific material (output structure, checklists, pitfalls, field-specific table) is interspersed.

2 / 5

Actionability

Some guidance is genuinely executable ("python -m py_compile scripts/main.py", "python scripts/main.py --help"), but a large fraction of the concrete guidance is non-executable fiction: code examples import `scripts.summarizer` and `scripts.batch` modules that do not exist, the "--field" flag shown in CLI examples is not implemented in main.py, and the Parameters table marks --input/--text/--url/--output all "Required" with empty descriptions, contradicting the actual CLI. This matches 'some concrete guidance but incomplete; missing key details' rather than the 4-anchor's 'mostly executable'.

3 / 5

Workflow Clarity

The Workflow section lists a sensible sequence with an explicit fallback path, and the pre/during/post summarization checklists plus "Quick Check" provide real checkpoints. However, the operational flow is scattered across five overlapping process sections (Workflow, Example run plan, Implementation Details, Output Requirements, Error Handling) with contradictory parameter documentation, so in practice the sequence and checkpoints are implicit and partly misleading. Not 4 — the duplication and incorrect CLI documentation undermine sequence confidence.

3 / 5

Progressive Disclosure

Scored against the actual bundle: the References section lists five files (`abstract_templates.md`, `quantitative_checklist.md`, `disciplinary_guidelines.md`, `journal_requirements.md`, `example_abstracts.md`), none of which exist as named; the Scripts section lists six scripts of which only `main.py` exists; and the real bundle files (`abstract-templates.md`, `evaluation-rubric.md`, `example-abstracts/cs-and-biomed-examples.md`) are never correctly referenced. Document-guided navigation fails outright, matching 'references are buried/broken' and content that belongs in separate files is inlined. Not 3 because the pointers, though clearly signaled, are systematically wrong.

2 / 5

Total

10

/

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 is concise, concrete, and third-person with a clearly stated purpose, but it omits any "when to use" trigger guidance and underuses natural keyword variations. It is serviceable yet sits just above the midpoint of the rubric.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user asks to summarize research papers, write abstracts, or condense academic articles/PDFs.'

Add natural synonyms users would actually say — 'research paper', 'literature', 'summarize', 'PDF' — to broaden trigger matching.

DimensionReasoningScore

Specificity

"Transform lengthy academic papers into concise, structured 250-word abstracts" names the domain and one concrete action with genuine specifics (word limit, structured output), but does not list several actions such as input formats, batch processing, or accuracy verification. It fits the anchor 'names domain and 1-2 concrete actions, but not comprehensive' rather than the 4-anchor's 'several specific actions'.

3 / 5

Completeness

There is a clear "what" (transform papers into 250-word structured abstracts) but no "Use when..." clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3. It is not 2 because the "what" is concrete and specific rather than vague.

3 / 5

Trigger Term Quality

Natural terms like "academic papers" and "abstracts" are present, but common variations users would say — "research paper", "literature", "summarize", "PDF" — are missing. This matches 'some relevant keywords but missing common variations or synonyms' rather than the 4-anchor's 'good keyword coverage; a few natural terms missing'.

3 / 5

Distinctiveness Conflict Risk

The academic-paper-to-250-word-structured-abstract niche is mostly distinct with only minor overlap risk against generic summarization skills, matching 'mostly distinct; minor overlap risk with closely related skills'. It is not 5 because the description lacks trigger phrases that would sharpen the boundary against general summarization requests.

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