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.
46
48%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Academic Writing/academic-abstract-refiner/SKILL.mdQuality
Discovery
75%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a reasonably well-crafted description with a clear 'use when' clause and a distinctive niche combining medical academic writing, SCI-style abstracts, and bilingual output. Its main weaknesses are moderate specificity (only one core action described) and limited trigger term coverage that could miss natural user phrasings. The description uses second person ('you need') in the trigger clause, which is a minor voice issue but doesn't severely impact functionality.
Suggestions
Add more specific concrete actions beyond 'refines/condenses', such as 'structures background-methods-results-conclusion sections, formats per journal guidelines, handles terminology translation'.
Expand trigger terms to include natural user phrasings like 'paper abstract', 'manuscript summary', 'journal submission', 'research paper', or '摘要' to improve matching coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (medical academic texts, SCI-style abstracts) and the core action (refines/condenses into bilingual abstracts), plus mentions generating Summary_Report.md. However, it doesn't list multiple distinct concrete actions beyond condensing—e.g., no mention of structuring sections, formatting citations, or handling specific abstract components. | 2 / 3 |
Completeness | The description clearly answers both 'what' (refines long medical academic texts into SCI-style unstructured Chinese and English abstracts) and 'when' (use when you need to condense drafts/reports/summaries into bilingual abstracts and generate Summary_Report.md), with an explicit 'use when' clause. | 3 / 3 |
Trigger Term Quality | Includes some relevant keywords like 'SCI-style', 'abstracts', 'bilingual', 'medical academic texts', 'Chinese and English', and 'Summary_Report.md'. However, it misses common user variations such as 'paper abstract', 'journal submission', 'manuscript', 'research paper', or '摘要' that users might naturally say. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of medical academic domain, SCI-style formatting, bilingual Chinese/English output, and the specific output file Summary_Report.md creates a very distinct niche that is unlikely to conflict with other skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
22%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is heavily padded with generic boilerplate sections (failure handling, safety rules, completion checklists, deterministic output rules) that apply to any skill and waste tokens without adding value. The core task—how to actually refine a long medical text into an SCI-style unstructured abstract—is barely addressed; the skill mostly documents a formatting script that writes pre-written abstracts to a file. The actionable content is thin and the workflow for the actual intellectual task is missing.
Suggestions
Remove all generic boilerplate sections (Failure Handling, Validation and Safety Rules, Deterministic Output Rules, Completion Checklist, When Not to Use, Required Inputs) that don't contain skill-specific information—these waste tokens on things Claude already knows.
Add concrete guidance for the actual abstract refinement process: how to identify key findings, what to include/exclude, word count targets, and an example showing a source text excerpt transformed into both Chinese and English abstracts.
Replace the generic 'Recommended Workflow' with specific steps: e.g., 1) Read source text and identify study type, 2) Extract key elements (objective, methods summary, main findings, conclusion), 3) Draft single-paragraph abstracts in both languages, 4) Verify no fabricated data, 5) Run the formatting script.
Include a concrete example of a well-formed SCI-style unstructured abstract (both Chinese and English) so Claude has a clear output template to follow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose and padded with generic boilerplate sections (Failure Handling, Validation and Safety Rules, Deterministic Output Rules, Completion Checklist) that are not specific to this skill and explain things Claude already knows. The 'When Not to Use', 'Required Inputs', 'Recommended Workflow', and 'Output Contract' sections are largely generic advice repeated across any skill, wasting significant token budget. | 1 / 3 |
Actionability | There is one concrete executable command (`python scripts/refine_abstract.py --abstract-zh ... --abstract-en ... --output Summary_Report.md`) which is helpful, but the actual core task—how to refine a long medical text into an SCI-style abstract—has no concrete guidance, examples of good abstracts, or specific instructions. The script merely formats already-written abstracts; the skill doesn't teach the actual refinement process. | 2 / 3 |
Workflow Clarity | The 'Recommended Workflow' section is entirely generic (validate inputs, select execution path, produce output, run validation) with no specifics about the actual abstract refinement process. There are no concrete steps for how to read the source text, extract key findings, draft the abstract, or validate its fidelity to the source. The workflow for the core task is essentially missing. | 1 / 3 |
Progressive Disclosure | The content is organized into sections with headers, which provides some structure. However, there are no bundle files or external references, and the content is a monolithic document with many generic boilerplate sections that could be removed entirely rather than split out. The structure exists but doesn't serve progressive disclosure effectively. | 2 / 3 |
Total | 6 / 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
73f6514
Table of Contents
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.