Generates a Meta-analysis results section description for funnel plots, including statistical tables (Egger's, Begg's, Trim & Fill) and figure legends. Supports English and Chinese outputs. Use when user provides a funnel plot image and statistics and wants a formatted report.
58
67%
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/meta-results-funnel-plot-generator/SKILL.mdQuality
Discovery
100%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 strong, well-crafted skill description that clearly defines a narrow, specialized domain (meta-analysis funnel plot reporting) with specific capabilities and explicit trigger conditions. It uses appropriate third-person voice, includes domain-specific terminology that researchers would naturally use, and provides a clear 'Use when' clause. The only minor improvement could be mentioning additional trigger variations, but the description is already highly effective.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: generates results section descriptions for funnel plots, includes statistical tables (Egger's, Begg's, Trim & Fill), generates figure legends, and supports bilingual output. These are highly specific and concrete capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Generates a Meta-analysis results section description for funnel plots, including statistical tables and figure legends') and when ('Use when user provides a funnel plot image and statistics and wants a formatted report'). | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'meta-analysis', 'funnel plot', 'Egger's', 'Begg's', 'Trim & Fill', 'figure legends', 'formatted report'. These are the exact terms a researcher would use when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche: meta-analysis funnel plot reporting with specific statistical tests (Egger's, Begg's, Trim & Fill). This is unlikely to conflict with other skills due to its very specialized domain. | 3 / 3 |
Total | 12 / 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 suffers from significant verbosity and repetition, with multiple sections restating the same information in slightly different boilerplate language. The core workflow (describe funnel plot → generate tables → assemble report) is identifiable but lacks concrete examples, executable code for the LLM interaction steps, and validation checkpoints. The document reads like it was auto-generated from a template without sufficient tailoring to the specific task.
Suggestions
Remove redundant sections ('When to Use', 'Key Features', 'Implementation Details') and consolidate into a concise overview + workflow structure, eliminating the boilerplate filler text.
Add a concrete input/output example showing sample statistics input and the expected formatted report output (at least a snippet), so Claude knows exactly what to produce.
Add validation steps to the workflow, such as verifying table format is valid Markdown, checking language consistency, and confirming the output follows the required structure order.
Fix the broken cross-references ('See ## Usage above' and 'See ## Workflow above') which point to sections that appear later in the document, not earlier.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose and repetitive. The 'When to Use' section restates the description multiple times in slightly different ways. 'Key Features' largely repeats the description again. 'Example Usage' references a non-existent '## Usage' section above it, and 'Implementation Details' references a non-existent '## Workflow' above it. Multiple sections contain boilerplate filler text that adds no value (e.g., 'Packaged executable path(s)', 'Structured execution path designed to keep outputs consistent and reviewable'). | 1 / 3 |
Actionability | There are some concrete elements like the bash commands for compilation and running the script, and the workflow steps describe a real process. However, there's no executable code showing how to actually call the LLM for description/table generation, no example input/output, and the 'Example run plan' is generic boilerplate rather than specific to this funnel plot task. The actual script invocation details (arguments, config format) are missing. | 2 / 3 |
Workflow Clarity | The Workflow section provides a reasonable 3-step sequence (Generate Description → Generate Tables → Assemble Report), and Quality Rules add some constraints. However, there are no validation checkpoints, no error recovery steps, and no verification that the output matches the requested language or structure. For a multi-step process involving LLM generation and script assembly, the lack of feedback loops caps this at 2. | 2 / 3 |
Progressive Disclosure | There is a reference to 'references/prompts.md' for LLM prompts, which is appropriate progressive disclosure. However, the main document itself is poorly organized with redundant sections ('When to Use', 'Key Features', 'Example Usage', 'Implementation Details' all overlap heavily). Cross-references like 'See ## Usage above' and 'See ## Workflow above' point to sections that appear BELOW, not above, creating confusion. | 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 | |
d3c2c0f
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.