CtrlK
BlogDocsLog inGet started
Tessl Logo

shell-python-heredoc

Execute complex Python code via run_shell heredoc when execute_code_sandbox fails

67

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./benchmarks/gdpval/skills/shell-python-heredoc/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

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 executable examples and clear sectioning, scoring well on actionability, workflow clarity, and progressive disclosure, with only mild conciseness slack in the advantages/disadvantages prose.

Suggestions

Tighten the Advantages/Disadvantages sections into terse bullets and verify the timeout claim ('60s default vs 30s') rather than leaving a possibly inaccurate comparison.

Consider trimming the 'See Also' cross-references or noting which are sibling skills, to keep the closing section strictly navigational.

DimensionReasoningScore

Conciseness

The body is mostly code-first and free of concept fluff, but sections like Advantages/Disadvantages and a questionable timeout claim ('60s default vs 30s') add explanation that could be tightened.

2 / 3

Actionability

It provides fully executable, copy-paste heredoc examples plus concrete syntax rules and a troubleshooting table, leaving no ambiguity about how to apply the pattern.

3 / 3

Workflow Clarity

As a single-action fallback it gives clear 'When to Use' decision guidance and recovery-oriented troubleshooting; the simple-task scoring note allows a 3 without an explicit validate-retry loop.

3 / 3

Progressive Disclosure

No bundle files exist and none are needed; the self-contained body is organized into clear, well-labeled sections, which satisfies progressive disclosure for a short single-purpose skill.

3 / 3

Total

11

/

12

Passed

Description

75%

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 clearly states what the skill does and when to apply it with a distinct, low-conflict trigger, but relies on internal tool jargon for its keywords and describes only one primary action rather than a comprehensive action set.

Suggestions

Expand specificity by listing a couple of concrete outcomes (e.g., '...for generating PDFs, processing data, or running multi-import scripts') so it covers multiple actions.

Soften trigger jargon by including natural phrasing a user might say, such as 'run a Python script' or 'execute Python code', alongside the tool names.

DimensionReasoningScore

Specificity

It names one concrete action ('Execute complex Python code via run_shell heredoc') and a failure trigger, but does not enumerate multiple distinct actions, matching 'Names domain and some actions, but not comprehensive'.

2 / 3

Completeness

It states both what it does ('Execute complex Python code via run_shell heredoc') and when to use it ('when execute_code_sandbox fails'), giving explicit trigger guidance.

3 / 3

Trigger Term Quality

Keywords like 'run_shell', 'heredoc', and 'execute_code_sandbox' are internal tool names rather than phrases a user would naturally say, so it has relevant but jargon-heavy coverage missing common variations.

2 / 3

Distinctiveness Conflict Risk

The niche is narrow and tied to a specific tool failure condition, making it unlikely to trigger for unrelated skills.

3 / 3

Total

10

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
HKUDS/OpenSpace
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.