unified-deliverables-flow

Generate spreadsheets, diagrams, and PDF reports in a phased workflow with explicit iteration budgets and error recovery

Quality

61%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./benchmarks/gdpval/skills/pdf-checklist-workflow-enhanced/SKILL.md

Quality

Content

62%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content has excellent workflow structure with strong validation and error recovery, but it is token-heavy due to oversized inlined code templates, one of which contains a syntax error, and it makes no use of progressive disclosure via bundle files.

Suggestions

Fix the non-executable PDF code: replace `colors '#2c3e50'` with `colors.HexColor('#2c3e50')` so the example is copy-paste ready.

Trim the inlined code blocks to minimal executable templates and move full styling-rich variants into reference files under references/ (e.g. spreadsheet_template.py, diagram_template.py, report_template.py) to improve both conciseness and progressive disclosure.

Reduce styling detail in the primary examples (fonts, borders, padding) to the essentials needed to demonstrate the generation pattern.

Dimension	Reasoning	Score
Conciseness	Prose is efficient and free of basic-concept explanations, but the three full code blocks (~60-90 lines each) carry heavy styling detail (fonts, colors, borders, padding) that could be tightened, matching the score-2 'could be tightened' anchor rather than the lean score-3 example.	2 / 3
Actionability	Most guidance is concrete and executable, but the PDF code block contains `colors '#2c3e50'`, a Python SyntaxError, so it is not copy-paste ready; this incomplete executable code fits the score-2 anchor.	2 / 3
Workflow Clarity	Phases 0-3 are clearly sequenced with explicit checkpoint criteria, verification shell commands after each phase, fallback feedback loops, and a complete checklist, matching the score-3 anchor with explicit validation and error recovery.	3 / 3
Progressive Disclosure	Sections are well-organized, but the ~420-line file is monolithic with no bundle files and three large code templates inlined that could be split into separate references, fitting the score-2 'content that should be separate is inline' anchor; the under-50-line exemption does not apply.	2 / 3
	Total	9 / 12 Passed

Description

60%

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 is specific and concrete about capabilities but omits explicit 'when to use' trigger guidance and lacks common keyword variations, leaving it solid but not exemplary.

Suggestions

Add a 'Use when...' clause with explicit triggers, e.g. 'Use when generating multiple artifact types (Excel, PNG, PDF) in one task or when iteration budgeting across deliverables matters'.

Include common natural variations users would say, such as 'Excel/.xlsx spreadsheets', 'charts/flowcharts', and 'PDFs', to broaden trigger coverage.

Sharpen distinctiveness by foregrounding the multi-deliverable phased-budget framing so it does not collide with single-purpose spreadsheet, diagram, or PDF skills.

Dimension	Reasoning	Score
Specificity	The phrase 'Generate spreadsheets, diagrams, and PDF reports' lists multiple specific concrete actions, matching the score-3 anchor; it is not vague or single-action like the score-2 example.	3 / 3
Completeness	It clearly states what the skill does but lacks any 'Use when...' clause or equivalent explicit trigger guidance, which the judging guidelines cap at 2.	2 / 3
Trigger Term Quality	'spreadsheets', 'diagrams', and 'PDF reports' are natural terms, but coverage misses common variations a user would say such as 'Excel', '.xlsx', 'charts', or 'flowcharts', fitting the score-2 anchor.	2 / 3
Distinctiveness Conflict Risk	The 'phased workflow with explicit iteration budgets and error recovery' niche is somewhat specific, but 'Generate spreadsheets, diagrams, and PDF reports' still overlaps standalone spreadsheet/diagram/PDF skills.	2 / 3
	Total	9 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: HKUDS/OpenSpace
Path: benchmarks/gdpval/skills/pdf-checklist-workflow-enhanced/SKILL.md
Commit: c5a9c4b

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.