document-python-direct

Use direct Python execution for reliable spreadsheet and document/PDF generation operations

Quality

57%

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/spreadsheet-direct-python-merged-f07ee1/SKILL.md

Quality

Content

65%

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

The content is highly actionable with complete executable examples and clear sequencing, but it is verbose for a single file, lacks validation feedback loops around destructive save operations, and keeps everything inline rather than progressively disclosing detail via references.

Suggestions

Add explicit validation checkpoints after destructive save operations (e.g., re-open the output workbook/PDF to confirm it loads and the expected sheet/page exists) to create a validate-then-proceed feedback loop.

Trim the 'Why Direct Execution?' rationale and generic troubleshooting entries to reduce token bloat while preserving the actionable file-first pattern.

Move the six worked examples and troubleshooting into a separate reference file so SKILL.md stays a lean overview with one-level-deep, clearly signaled references.

Dimension	Reasoning	Score
Conciseness	The body avoids explaining concepts Claude already knows (no 'what is a PDF' filler) and uses concrete code, but the 'Why Direct Execution?' rationale and generic troubleshooting entries add padding that could be trimmed; it is mostly efficient rather than lean.	2 / 3
Actionability	Six fully executable, copy-paste-ready Python examples plus concrete file-first/inline patterns and specific commands give direct, runnable guidance with no pseudocode.	3 / 3
Workflow Clarity	The recommended write-to-file-then-execute pattern is clearly sequenced, but operations that overwrite spreadsheets/PDFs lack explicit validation or verification checkpoints, so per the feedback-loop guidance workflow clarity is capped at 2.	2 / 3
Progressive Disclosure	The file is well-sectioned but monolithic at ~278 lines with all six examples, troubleshooting, and the library table inline and no external references, so content that could be split into reference files stays in SKILL.md.	2 / 3
	Total	9 / 12 Passed

Description

50%

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 a clear domain and method but stops short of listing concrete actions, omits an explicit 'Use when' trigger clause, and leans on technical phrasing. It is adequate but not standout, scoring 2 across all dimensions.

Suggestions

Add an explicit 'Use when...' trigger clause (e.g., 'Use when generating or transforming Excel spreadsheets, PDF reports, or Word documents via Python scripts') to lift completeness and trigger term quality.

Include natural user variations such as Excel, .xlsx, reports, and Word/.docx alongside 'spreadsheet', 'document', and 'PDF' to broaden trigger term coverage.

Enumerate concrete actions (read, transform, format, generate) rather than the single generic 'generation operations' to sharpen specificity and reduce overlap with generic document skills.

Dimension	Reasoning	Score
Specificity	The phrase 'spreadsheet and document/PDF generation operations' names the domain and a broad action (generation) with a concrete method ('direct Python execution'), but it does not enumerate multiple specific actions (e.g., read, transform, format, fill forms) the way the score-3 anchor does.	2 / 3
Completeness	It states what the skill does but lacks any 'Use when...' clause or equivalent explicit trigger guidance, so per the judging guidelines completeness is capped at 2.	2 / 3
Trigger Term Quality	It contains natural terms users would say ('spreadsheet', 'document', 'PDF'), but misses common variations (Excel, .xlsx, reports, Word) and leads with the technical jargon 'direct Python execution' rather than user-facing language.	2 / 3
Distinctiveness Conflict Risk	'Direct Python execution for ... document/PDF generation' is moderately specific but 'document/PDF generation' could still overlap with general document-creation skills, and the absence of distinct triggers leaves some conflict risk.	2 / 3
	Total	8 / 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/spreadsheet-direct-python-merged-f07ee1/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.