Use conference poster pitch for academic writing workflows that need structured execution, explicit assumptions, and clear output boundaries.
36
33%
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/conference-poster-pitch/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 fails to explain what the skill actually does—it names a domain ('conference poster pitch') but lists no concrete actions or outputs. The 'Use when' clause relies on abstract process qualities rather than specific task triggers. While it has some relevant keywords, the overall lack of specificity and concrete capability listing makes it difficult for Claude to confidently select this skill.
Suggestions
Add specific concrete actions the skill performs, e.g., 'Generates structured conference poster pitches by summarizing research objectives, methods, key findings, and conclusions into poster-ready sections.'
Replace abstract process descriptors ('structured execution, explicit assumptions, clear output boundaries') with concrete trigger scenarios, e.g., 'Use when the user needs to create a poster presentation, summarize research for a conference, or prepare a visual abstract for an academic event.'
Include natural keyword variations users might say, such as 'research poster', 'poster presentation', 'poster session', 'conference abstract', or 'poster layout'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description does not list any concrete actions. 'Conference poster pitch' names a domain but no specific capabilities like 'create poster layouts', 'summarize research findings', or 'design visual abstracts'. 'Structured execution, explicit assumptions, and clear output boundaries' are abstract process descriptors, not concrete actions. | 1 / 3 |
Completeness | It has a 'Use when' clause ('academic writing workflows that need structured execution, explicit assumptions, and clear output boundaries'), but the 'what' is extremely weak—it never explains what the skill actually does. The 'when' criteria are also vague and process-oriented rather than task-specific. | 2 / 3 |
Trigger Term Quality | It includes some relevant keywords like 'conference poster pitch' and 'academic writing', which a user might naturally say. However, it misses common variations such as 'poster presentation', 'research poster', 'poster design', 'abstract', or 'conference submission'. | 2 / 3 |
Distinctiveness Conflict Risk | 'Conference poster pitch' provides some niche specificity, but 'academic writing workflows' is broad enough to overlap with other academic writing skills. The process-oriented qualifiers ('structured execution, explicit assumptions') don't help distinguish it from other structured academic tools. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
27%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 (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template) that are not specific to conference poster pitch generation and waste significant context window space. The core actionable content—CLI parameters and usage examples—is solid but buried. Circular internal references ('See X above') create confusion rather than clarity.
Suggestions
Remove or drastically reduce boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template) that don't contain poster-pitch-specific guidance—these waste tokens on generic project management scaffolding.
Eliminate circular cross-references ('See ## Prerequisites above', 'See ## Usage above') and consolidate related content into a single location.
Add concrete examples of expected output (e.g., a sample 60-second pitch) so Claude knows what a good result looks like.
Restructure to lead with the essential content (parameters, usage examples, expected output format) and move any remaining supplementary material to referenced files rather than inlining everything.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose and repetitive. Multiple sections reference each other circularly ('See ## Prerequisites above', 'See ## Usage above', 'See ## Workflow above'). Contains extensive boilerplate (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that adds no actionable value for Claude. The core task—generating an elevator pitch—is buried under layers of generic project management scaffolding that Claude doesn't need. | 1 / 3 |
Actionability | The CLI usage examples with concrete flags (--poster-title, --duration) and the parameter table are actionable. However, the skill relies entirely on an opaque `scripts/main.py` whose implementation is not provided, making it impossible to verify executability. The 'Example run plan' and 'Workflow' sections are generic process descriptions rather than concrete, task-specific instructions. | 2 / 3 |
Workflow Clarity | The Workflow section provides a numbered sequence with validation and fallback steps, and the Error Handling section adds useful guidance. However, the steps are generic and not specific to poster pitch generation. There are no concrete validation checkpoints (e.g., checking output quality or format), and the workflow lacks feedback loops for iterating on pitch quality. | 2 / 3 |
Progressive Disclosure | The document is a monolithic wall of text with 15+ sections, many of which are boilerplate. Internal cross-references are circular and confusing ('See ## Prerequisites above' appears in Dependencies, but Prerequisites just says 'No additional Python packages required'). References to `references/audit-reference.md` and bundle files cannot be verified since no bundle is provided. Content that could be separate (Risk Assessment, Security Checklist, Lifecycle Status) is inlined unnecessarily. | 1 / 3 |
Total | 6 / 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.