CtrlK
BlogDocsLog inGet started
Tessl Logo

academic-abstract-refiner

Refines long medical academic texts into SCI-style unstructured Chinese and English abstracts; use when you need to condense drafts/reports/summaries into bilingual abstracts and generate Summary_Report.md.

55

Quality

69%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

Quality

Content

50%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 actionable core — the script contract, concrete command, and format constraints (unstructured single-paragraph, bilingual, no fabricated data) — is genuinely good. It is buried under substantial generic boilerplate (roughly half the body), duplicated validation sections, and a confusing placeholder/competing output filename, which hurt token efficiency and dilute workflow clarity.

Suggestions

Delete the generic boilerplate sections (Required Inputs, Output Contract, Validation and Safety Rules, Failure Handling, Deterministic Output Rules, Completion Checklist) and merge 'Validation Shortcut' with 'Quick Validation' — they repeat the same `--help` command; keep only the script contract, format constraints, content-integrity rules, and example.

Fix the example placeholder `--abstract-zh "(、)。"` with a short realistic Chinese abstract sample, and remove the Output Contract's competing `academic_abstract_refiner_result.md` name so `Summary_Report.md` is the single documented deliverable.

Rewrite 'Recommended Workflow' to reference the actual steps — refine abstracts from the source, then run `python scripts/refine_abstract.py --abstract-zh <zh> --abstract-en <en> --output Summary_Report.md`, then verify the report contains both single-paragraph abstracts — instead of the current skill-agnostic four-step sequence.

DimensionReasoningScore

Conciseness

Roughly half the body is generic boilerplate that would apply to any skill and teaches Claude nothing new: "Required Inputs", "Recommended Workflow", "Output Contract", "Validation and Safety Rules", "Failure Handling", "Deterministic Output Rules", and "Completion Checklist" contain only abstract directives like "Validate required inputs before execution and stop early when mandatory fields or files are missing." The same `--help` command is even repeated in two sections ("Validation Shortcut" and "Quick Validation"). This matches anchor 2 (noticeably verbose, several unnecessary padded sections) rather than 3, because the padding is extensive and systematic rather than incidental.

2 / 5

Actionability

The core guidance is concrete and executable: `python scripts/refine_abstract.py --abstract-zh ... --abstract-en ... --output Summary_Report.md` (the script exists in scripts/ and matches the documented contract), plus a `--help` validation command and an expected-output description. It stays at 4 rather than 5 because the example placeholder for the Chinese abstract is the literal punctuation string "(、)。" (confusing rather than illustrative), and the Output Contract introduces a competing default filename (`academic_abstract_refiner_result.md`) that muddies the documented `Summary_Report.md` convention.

4 / 5

Workflow Clarity

A sequence exists — validate inputs, produce the abstracts as the agent, then run the script to render `Summary_Report.md` — and "Example Usage" explicitly says to generate the report "after you already have the refined abstracts (produced by the agent)". However, the checkpoints are generic and scattered: "Recommended Workflow" never mentions the script or its command, validation is reduced to a duplicated `--help` run, and there is no verify-output step tied to the actual deliverable. This fits anchor 3 (sequence present but checkpoints missing or implicit) rather than 4, which requires most checkpoints to be concrete.

3 / 5

Progressive Disclosure

The body has real section headers and its only bundle reference (`scripts/refine_abstract.py`) is a real, correctly pathed file, so navigation is possible. But at ~120 lines for a single-purpose render task, the skill keeps large volumes of boilerplate inline (seven-plus generic policy sections) and duplicates content (two validation sections), fitting anchor 3's "could be better organized" rather than 4's "most content is appropriately placed" — the fix is deletion rather than extraction, but the current split is not appropriate.

3 / 5

Total

12

/

20

Passed

Description

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

A solid description that clearly states both what the skill does and when to use it, with a well-defined medical/academic bilingual-abstract niche. Trigger coverage is good but lacks common synonyms (manuscript, paper, 摘要), and the 'when' clause could use more user-side trigger phrasing.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Refines long medical academic texts into SCI-style unstructured Chinese and English abstracts", "condense drafts/reports/summaries into bilingual abstracts", "generate Summary_Report.md" — with the domain clearly named. It falls short of anchor 5 because the actions are all variations of one core task (refine → render) rather than comprehensive, distinct capabilities.

4 / 5

Completeness

Both parts are explicit: "Refines long medical academic texts into SCI-style unstructured Chinese and English abstracts" answers what, and "use when you need to condense drafts/reports/summaries into bilingual abstracts and generate Summary_Report.md" answers when. It stays at 4 rather than 5 because the 'when' clause is framed around the task need rather than concrete user-side trigger phrases (e.g., "use when the user asks for an abstract" or mentions of specific input types).

4 / 5

Trigger Term Quality

Natural trigger terms are present and varied: "medical academic texts", "SCI-style", "Chinese and English abstracts", "drafts/reports/summaries", "bilingual abstracts", "Summary_Report.md". It misses common variations users would say — "abstract" alone, "manuscript", "paper summary", Chinese-language triggers like "摘要" — so it fits anchor 4 (good coverage, a few natural terms missing) rather than anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is clear and fairly distinct — medical/academic bilingual abstract refinement with a named deliverable — so it is unlikely to trigger for unrelated skills. It does not reach 5 because "condense drafts/reports/summaries" overlaps broadly with general summarization skills, leaving minor conflict risk with closely related skills.

4 / 5

Total

16

/

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.