CtrlK
BlogDocsLog inGet started
Tessl Logo

abstract-trimmer

Precision editing tool that reduces abstract word count through intelligent compression techniques, maintaining scientific rigor while meeting strict journal and conference requirements.

22

Quality

11%

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/abstract-trimmer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

7%

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 description relies heavily on marketing-style language ('precision editing tool', 'intelligent compression techniques') without specifying concrete actions or providing trigger guidance. It fails to include natural user keywords and lacks an explicit 'Use when...' clause, making it difficult for Claude to reliably select this skill from a pool of alternatives.

Suggestions

Replace vague phrases like 'intelligent compression techniques' with concrete actions such as 'removes redundant phrases, shortens sentences, consolidates clauses to reduce word count in academic abstracts'.

Add an explicit 'Use when...' clause with natural trigger terms like 'shorten abstract', 'reduce word count', 'abstract too long', 'conference word limit', 'journal submission length'.

Include specific file types or contexts (e.g., 'scientific paper abstracts', 'LaTeX documents') to improve distinctiveness and trigger accuracy.

DimensionReasoningScore

Specificity

The description uses vague, buzzword-heavy language like 'intelligent compression techniques' and 'precision editing tool' without listing concrete actions. It doesn't specify what actions are performed (e.g., shortening sentences, removing redundancies, rephrasing clauses).

1 / 3

Completeness

The 'what' is vaguely stated as reducing abstract word count, but there is no explicit 'when' clause or trigger guidance. There is no 'Use when...' or equivalent, and the what itself is too abstract to be useful.

1 / 3

Trigger Term Quality

The description lacks natural keywords a user would say. Terms like 'intelligent compression techniques' and 'scientific rigor' are not what users would type. Missing natural triggers like 'shorten abstract', 'word count', 'reduce length', 'conference submission', 'paper abstract'.

1 / 3

Distinctiveness Conflict Risk

The mention of 'abstract word count', 'journal and conference requirements' does narrow the domain to academic writing, which provides some distinctiveness. However, it could overlap with general academic writing or editing skills.

2 / 3

Total

5

/

12

Passed

Implementation

14%

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

This skill suffers from severe verbosity, circular internal references, and generic boilerplate that overwhelms the actual domain-specific content. While it provides some concrete CLI examples and a useful parameter table, the core value proposition—how to intelligently compress abstracts while preserving scientific rigor—is barely addressed. The workflow sections are entirely generic and could apply to any skill, missing the opportunity to provide abstract-trimming-specific guidance and validation steps.

Suggestions

Remove all circular self-references ('See ## Features above') and consolidate redundant sections (Workflow, Implementation Details, Example Usage) into a single clear workflow with abstract-trimming-specific validation steps (e.g., verify quantitative data preserved, check BMRC structure maintained).

Cut generic boilerplate sections (Security Checklist, Risk Assessment, Response Template, Output Requirements, Input Validation, Error Handling) that don't add domain-specific value—these consume tokens on things Claude already knows how to do.

Add concrete examples of actual abstract trimming: show a before/after abstract with each strategy (conservative/balanced/aggressive) so Claude understands what compression looks like in practice.

Add validation checkpoints specific to abstract trimming: verify key statistics are preserved, confirm word count meets target, check that BMRC structure is maintained, and flag if critical findings were removed.

DimensionReasoningScore

Conciseness

Extremely verbose and repetitive. Multiple sections reference each other circularly ('See ## Features above', 'See ## Usage above', 'See ## Workflow above'). The 'When to Use' section repeats the description verbatim. Boilerplate sections like Security Checklist, Risk Assessment, Response Template, Output Requirements, and Input Validation add significant token overhead with generic content that Claude already knows. The same information (e.g., py_compile commands, script paths) is repeated across multiple sections.

1 / 3

Actionability

The skill provides concrete CLI commands with specific parameters and a parameter table, which is useful. However, the actual trimming logic and compression techniques are never explained—the skill assumes a working scripts/main.py exists but provides no guidance on how the compression actually works or how Claude should perform abstract trimming if the script is unavailable. The 'Audit-Ready Commands' section has executable examples, but the workflow steps are generic and not specific to abstract trimming.

2 / 3

Workflow Clarity

The 'Workflow' section contains only generic steps ('Confirm the user objective', 'Validate that the request matches') that could apply to any skill. There are no validation checkpoints specific to abstract trimming (e.g., verify key findings preserved, check word count meets target, validate no quantitative data lost). The 'Example run plan' is similarly generic. No feedback loops for the core task of trimming and validating scientific content.

1 / 3

Progressive Disclosure

The document is a monolithic wall of text with circular self-references ('See ## Features above', 'See ## Usage above') that add confusion rather than navigation. References to 'references/' directory are mentioned but no bundle files are provided. Content is poorly organized with redundant sections (Dependencies is empty, Prerequisites repeats information, multiple overlapping workflow/implementation sections). The document could be significantly restructured with clear separation of concerns.

1 / 3

Total

5

/

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.