poster-layout-planner
Use poster layout planner for other workflows that need structured execution, explicit assumptions, and clear output boundaries.
33
Quality
17%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Academic Writing/poster-layout-planner/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 fails on all dimensions. It provides no concrete actions, uses abstract jargon instead of natural user language, and lacks any specific domain or use case. The phrase 'other workflows' suggests this is meant as a fallback or secondary use, which makes it even harder to understand when to select this skill.
Suggestions
Replace abstract terms with concrete actions - specify exactly what the poster layout planner does (e.g., 'Creates visual layouts for posters, arranges text and image blocks, generates print-ready designs').
Add natural trigger terms users would actually say (e.g., 'poster design', 'layout', 'print materials', 'visual arrangement', 'flyer').
Rewrite the 'Use when' clause with specific scenarios (e.g., 'Use when the user needs to design posters, create visual layouts, or arrange content for print materials').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language like 'other workflows' and 'structured execution' without naming any concrete actions. There are no specific capabilities listed - only abstract concepts. | 1 / 3 |
Completeness | The 'what' is extremely vague (no concrete actions described), and while there's a 'Use when' structure, the triggers are abstract concepts ('structured execution', 'explicit assumptions') rather than actionable guidance. | 1 / 3 |
Trigger Term Quality | The only potentially natural term is 'poster layout planner' but it's unclear what this means. Terms like 'structured execution' and 'output boundaries' are technical jargon users wouldn't naturally say. | 1 / 3 |
Distinctiveness Conflict Risk | The description is so generic ('other workflows', 'structured execution') that it could apply to almost any skill. There's no clear niche or distinct domain identified. | 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 suffers from severe verbosity and template bloat, with generic boilerplate sections (Security Checklist, Risk Assessment, Evaluation Criteria) that don't provide poster-layout-specific value. The core functionality - actually designing poster layouts - is poorly demonstrated with no concrete examples of input poster specifications producing layout recommendations. The document prioritizes process documentation over actionable guidance.
Suggestions
Remove generic boilerplate sections (Security Checklist, Risk Assessment, Evaluation Criteria, Lifecycle Status) that don't add poster-layout-specific value
Add a concrete example showing sample input (poster size, sections list) and the expected JSON output with actual layout recommendations
Consolidate redundant sections - the workflow is described in at least 3 places (Example Usage, Implementation Details, Workflow)
Remove self-referential cross-references like 'See ## Features above' and integrate that content directly where needed
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose with significant redundancy - multiple sections repeat the same information (e.g., 'See ## Features above' cross-references, duplicate workflow descriptions). Contains boilerplate that doesn't add value like generic security checklists and evaluation criteria that Claude already knows. | 1 / 3 |
Actionability | Provides some concrete commands (python -m py_compile, python scripts/main.py) and input/output format specifications, but the core task of 'designing academic poster layouts' lacks executable examples showing actual poster layout generation with sample inputs and expected outputs. | 2 / 3 |
Workflow Clarity | Workflow steps are listed but generic and lack specificity for poster layout design. The 5-step workflow could apply to any skill. Missing concrete validation checkpoints specific to poster layouts (e.g., how to verify section placement is correct, what constitutes valid visual hierarchy). | 2 / 3 |
Progressive Disclosure | References external files (scripts/main.py, references/) appropriately, but the main document is bloated with sections that should be condensed or removed. The structure exists but content organization is poor with redundant cross-references like 'See ## Features above' that add 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 | |
- Repository
- aipoch/medical-research-skills
- Commit
4a48721
- 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.