CtrlK
BlogDocsLog inGet started
Tessl Logo

tool-use-guardian

FREE — Intelligent tool-call reliability wrapper. Monitors, retries, fixes, and learns from tool failures. Auto-recovers from truncated JSON, timeouts, rate limits, and mid-chain failures.

36

Quality

33%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/tool-use-guardian/SKILL.md

The canonical home for this skill is tool-use-guardian in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

17%Scale 1-5

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

This skill reads as a marketing landing page or README for a product rather than an actionable skill that teaches Claude how to perform a task. It contains no executable code, no concrete integration examples, and no real instructions — just a conceptual description of what 'Guardian' does. The promotional language, cross-selling of other marketplace skills, and external links further detract from its utility as a skill file.

Suggestions

Replace the conceptual description with actual executable code showing how to wrap a tool call with Guardian's retry/recovery logic — e.g., a concrete Python or JavaScript example with imports, configuration, and invocation.

Remove all marketing language ('Free forever', 'Built by the Genesis Agent Marketplace', cross-selling other skills) and focus exclusively on actionable instructions.

Add a concrete workflow example: show a real multi-step tool chain, demonstrate what happens when step N fails, and include validation/verification steps with actual commands.

Provide configuration examples showing how to customize retry counts, backoff parameters, and failure classification thresholds rather than just listing them in a table.

DimensionReasoningScore

Conciseness

The content is noticeably verbose with marketing fluff ('The reliability wrapper every AI agent needs', 'Free forever', 'Built by the Genesis Agent Marketplace'), explains concepts Claude already understands (what truncated JSON is, what rate limiting is), and includes promotional cross-links. The 'When to Use This Skill' section largely restates obvious use cases.

2 / 5

Actionability

There is zero executable code, no concrete commands beyond a dubious `npx skills add` install line, no API usage examples, no configuration snippets, and no demonstration of how to actually integrate or invoke Guardian. The entire skill reads as a product description rather than actionable instructions.

1 / 5

Workflow Clarity

While there is a numbered 4-step sequence describing how Guardian conceptually works, the steps are entirely descriptive with no concrete commands, no validation checkpoints, and no feedback loops. There's no guidance on what to do when things go wrong or how to verify Guardian is working correctly.

2 / 5

Progressive Disclosure

No bundle files are provided, yet the content is a monolithic marketing-style document with no references to detailed configuration, API docs, or examples files. The table of failure types could benefit from linking to detailed recovery documentation. The structure is flat with no clear navigation to deeper content.

2 / 5

Total

7

/

20

Passed

Description

50%Scale 1-5

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 does a decent job naming specific failure modes and recovery actions, giving it reasonable specificity and distinctiveness. However, it lacks any explicit 'Use when...' trigger guidance, which is a significant gap for skill selection. The marketing-style 'FREE —' prefix and terms like 'intelligent' and 'auto-recovers' lean toward buzzword territory without adding selection clarity.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when a tool call fails, returns an error, times out, or produces malformed output.'

Replace the marketing prefix 'FREE — Intelligent' with functional language; the word 'FREE' and 'Intelligent' are not useful for skill selection and read as promotional.

Include more natural user-facing trigger terms such as 'tool error', 'API failure', 'broken tool response', or 'tool call not working' to improve matching with how users describe these problems.

DimensionReasoningScore

Specificity

Lists several specific actions: monitors, retries, fixes, and learns from tool failures. Also names concrete failure types: truncated JSON, timeouts, rate limits, mid-chain failures. Minor gaps in explaining exactly how it accomplishes these (e.g., what 'learns' means concretely).

4 / 5

Completeness

Has a reasonable 'what' (monitors, retries, fixes tool failures) but completely lacks a 'when' clause. There is no 'Use when...' guidance, which per the rubric should cap this at 3, and since the 'what' is present but 'when' is entirely absent, a score of 2 is appropriate.

2 / 5

Trigger Term Quality

Includes some relevant technical terms like 'tool failures', 'truncated JSON', 'timeouts', 'rate limits', but these are more developer-facing jargon than natural user phrases. Missing natural trigger phrases a user might say like 'tool error', 'tool not working', 'API failing', 'retry tool call'.

3 / 5

Distinctiveness Conflict Risk

The niche of tool-call reliability and failure recovery is fairly distinct and unlikely to overlap with most other skills. However, 'monitors' and 'retries' could potentially overlap with general error-handling or observability skills. The specific focus on tool-call failures provides reasonable distinctiveness.

4 / 5

Total

13

/

20

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.