CtrlK
BlogDocsLog inGet started
Tessl Logo

ehr-semantic-compressor

1. Confirm the user objective, required inputs, and non-negotiable constraints before doing detailed work. 2. Validate that the request matches the documented scope and stop early if the task would require unsupported as.

26

Quality

17%

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/ehr-semantic-compressor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

0%

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 reads like generic meta-instructions for how to handle any task rather than a description of a specific skill's capabilities. It lacks any concrete actions, domain specificity, trigger terms, or 'use when' guidance. The text also appears truncated ('unsupported as'), further reducing its utility.

Suggestions

Replace the generic process steps with concrete actions describing what the skill actually does (e.g., 'Generates project requirement documents' or 'Validates API request schemas').

Add a 'Use when...' clause with specific trigger terms that reflect what users would naturally say when they need this skill.

Identify the specific domain or task type this skill covers and name it explicitly to distinguish it from other skills.

DimensionReasoningScore

Specificity

The description contains no concrete actions or domain-specific capabilities. Phrases like 'confirm the user objective' and 'validate that the request matches the documented scope' are entirely abstract and could apply to any skill.

1 / 3

Completeness

The description fails to answer 'what does this do' in any concrete way and completely lacks a 'when should Claude use it' clause. It reads like generic process instructions rather than a skill description.

1 / 3

Trigger Term Quality

There are no natural keywords a user would say. Terms like 'non-negotiable constraints', 'documented scope', and 'unsupported as' (which appears truncated) are not phrases users would use in requests.

1 / 3

Distinctiveness Conflict Risk

The description is entirely generic—confirming objectives and validating scope could apply to virtually any skill. It provides no distinguishing domain, file type, or task category, making it highly prone to conflicts.

1 / 3

Total

4

/

12

Passed

Implementation

35%

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

This skill is excessively verbose and repetitive, with the core description repeated verbatim in multiple sections and large amounts of generic boilerplate (security checklists, lifecycle status, evaluation criteria, response templates) that don't add task-specific value. While it does provide some concrete elements—CLI commands, JSON schemas, parameter tables—the overall document is poorly organized with circular internal references and could be dramatically condensed. The medical EHR summarization domain warrants stronger validation checkpoints than what is provided.

Suggestions

Remove all repeated content: the skill description appears verbatim in 'When to Use', 'Key Features', and 'Workflow'—consolidate into a single clear statement.

Cut generic boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template, Output Requirements) that Claude already knows or that don't contain task-specific information.

Add explicit validation checkpoints in the workflow, such as verifying output completeness against extracted sections and checking clinical accuracy metrics before returning results.

Fix circular cross-references ('See ## Usage above' appearing before the Usage section) and reorganize so the document flows logically: Overview → Quick Start → Usage → Workflow → References.

DimensionReasoningScore

Conciseness

Extremely verbose and repetitive. The same description ('Confirm the user objective, required inputs...') is repeated verbatim in 'When to Use', 'Key Features', and 'Workflow'. Sections like 'Risk Assessment', 'Security Checklist', 'Evaluation Criteria', 'Lifecycle Status', 'Response Template', and 'Output Requirements' add significant boilerplate that Claude already knows. Many sections cross-reference each other circularly ('See ## Usage above', 'See ## Workflow above'). The document could be cut by 60%+ without losing actionable content.

1 / 3

Actionability

There are concrete commands (python scripts/main.py --input/--output), input/output JSON schemas, and a parameter table, which provide some executable guidance. However, much of the content is generic boilerplate rather than task-specific instructions, the 'Example Usage' section says 'See ## Usage above' before the Usage section appears, and there's no actual executable code showing how the summarization logic works—just CLI invocations of a script whose contents are unknown.

2 / 3

Workflow Clarity

The Workflow section provides a 5-step sequence and the Example Usage has a 4-step run plan, both of which outline the process. However, there are no explicit validation checkpoints between steps (e.g., verifying output quality or checking intermediate results). The error handling section mentions fallbacks but doesn't integrate them into the workflow steps as feedback loops. For a medical/clinical tool involving potentially destructive summarization of health records, the lack of validation checkpoints is a notable gap.

2 / 3

Progressive Disclosure

References to external files (references/requirements.txt, references/guidelines.md, references/sample_input.json, references/sample_output.json, scripts/main.py) are present and clearly listed. However, the SKILL.md itself is monolithic with massive inline content that could be split out (e.g., the full parameter table, technical architecture details, security checklist, risk assessment). The circular cross-references ('See ## Usage above') are confusing rather than helpful. No bundle files were provided to verify reference accuracy.

2 / 3

Total

7

/

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.