Use study limitations drafter for academic writing workflows that need structured execution, explicit assumptions, and clear output boundaries.
32
26%
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/study-limitations-drafter/SKILL.mdQuality
Discovery
40%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description names the skill's domain (study limitations in academic writing) but fails to specify concrete actions it performs and relies on abstract, buzzword-heavy language. It lacks explicit trigger guidance and natural user keywords, making it difficult for Claude to reliably select this skill from a pool of alternatives.
Suggestions
List specific concrete actions the skill performs, e.g., 'Drafts structured study limitations sections identifying methodological constraints, sample size issues, generalizability concerns, and potential biases.'
Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks for help writing a limitations section, discussing study weaknesses, or drafting the limitations portion of a research paper, thesis, or manuscript.'
Remove vague qualifiers like 'structured execution', 'explicit assumptions', and 'clear output boundaries' and replace them with concrete descriptions of what the skill outputs.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague, abstract language like 'structured execution', 'explicit assumptions', and 'clear output boundaries' without listing any concrete actions. It does not specify what the skill actually does beyond naming itself ('study limitations drafter'). | 1 / 3 |
Completeness | The 'what' is weakly implied (drafting study limitations) and the 'when' clause ('for academic writing workflows that need structured execution...') is present but vague and not framed with explicit trigger guidance. The lack of a clear 'Use when...' clause with concrete triggers caps this at 2. | 2 / 3 |
Trigger Term Quality | It includes some relevant terms like 'study limitations', 'academic writing', and 'drafter', which a user might mention. However, it misses common variations like 'research limitations', 'manuscript', 'paper', 'thesis', or 'discussion section'. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'study limitations' provides some niche specificity, but 'academic writing workflows' is broad enough to overlap with other academic writing skills. The vague qualifiers ('structured execution', 'explicit assumptions') don't help distinguish it. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
12%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 (security checklists, lifecycle status, evaluation criteria) that provide no task-specific value, while lacking the concrete, actionable content needed to actually draft study limitations. The core task—generating limitation paragraphs from inputs—is barely illustrated with a single sentence fragment example. The document repeats itself extensively and contains circular cross-references to empty or near-empty sections.
Suggestions
Remove all generic boilerplate sections (Security Checklist, Lifecycle Status, Evaluation Criteria, Risk Assessment) and reduce the document to under 80 lines focused on the actual limitation-drafting task.
Add 2-3 complete input/output examples showing specific limitations lists being transformed into professionally worded limitation paragraphs, including both 'minor' and 'major' severity examples.
Replace the abstract workflow steps with concrete instructions: show exactly what the script expects as input (e.g., a JSON or YAML file with the parameters), what it produces, and include a complete example invocation with sample output.
Fix circular cross-references ('See ## Prerequisites above' → empty section) and consolidate redundant content—the skill description appears verbatim in at least 3 places.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose and repetitive. Multiple sections restate the same information (e.g., 'scripts/main.py' is mentioned 6+ times, the skill description is repeated verbatim in 'When to Use' and 'Key Features'). Contains boilerplate sections like 'Lifecycle Status', 'Security Checklist', and 'Evaluation Criteria' with generic placeholder content that adds no actionable value. Cross-references to sections that don't exist or are circular ('See ## Prerequisites above for related details' when Prerequisites just says 'No additional Python packages required'). | 1 / 3 |
Actionability | Despite the length, there is almost no concrete, executable guidance for the actual task of drafting study limitations. The 'Example' section contains a single sentence fragment. The parameters table defines inputs but there's no code showing how to use them. The workflow steps are abstract process descriptions ('Confirm the user objective') rather than concrete instructions. The bash commands only show how to compile-check and get help from a script we can't see. | 1 / 3 |
Workflow Clarity | The workflow section provides a numbered sequence with some validation logic (step 2: stop early if out of scope, step 5: fallback path). Error handling and input validation sections add recovery guidance. However, the steps are abstract and lack concrete validation checkpoints—there's no specific command to verify output quality, no example of what a successful vs failed run looks like, and the workflow is more of a generic process template than a task-specific sequence. | 2 / 3 |
Progressive Disclosure | The document is a monolithic wall of text with 15+ sections, many containing boilerplate or redundant content. References to 'references/audit-reference.md' and 'references/' directory exist but no bundle files are provided to verify them. Internal cross-references are circular and broken ('See ## Prerequisites above' pointing to a near-empty section, 'See ## Workflow above' from Implementation Details). Content that could be in separate files (Risk Assessment, Security Checklist, Evaluation Criteria) is inlined. | 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.
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.