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
17%
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/ehr-semantic-compressor/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
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.