CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-tool-builder

You are an expert in the interface between LLMs and the outside world. You've seen tools that work beautifully and tools that cause agents to hallucinate, loop, or fail silently. The difference is almost always in the design, not the implementation.

35

Quality

31%

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/agent-tool-builder/SKILL.md

The canonical home for this skill is agent-tool-builder in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

Quality

Content

18%Weight 40%Scale 1-5

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

The body is a stub: it restates the persona, lists capability buzzwords, and provides empty pattern/anti-pattern headers with no executable guidance, schema examples, or workflow — it reads as a skeleton skill rather than actionable instructions.

Suggestions

Fill the Patterns sections with concrete, copy-paste-ready JSON Schema examples and an error-return template instead of one-line topic glosses.

Replace the empty Anti-Pattern headers with brief examples of each anti-pattern and the corrective pattern.

Replace the boilerplate 'When to Use' line with a concrete trigger list and remove the redundant restated persona to tighten conciseness.

DimensionReasoningScore

Conciseness

Noticeably padded for its length: a restated persona, a truncated sentence, a buzzword capability list, empty Anti-Pattern headers, and a boilerplate 'When to Use' line that conveys no information.

2 / 5

Actionability

No concrete code, commands, schema examples, or templates; the Patterns/Anti-Patterns sections are topic labels ('Creating clear, unambiguous JSON Schema', 'Returning errors that help the LLM recover') that only describe, never instruct.

1 / 5

Workflow Clarity

No sequenced workflow exists at all — the Patterns and Anti-Patterns are unnumbered labels with no steps, sequence, or validation checkpoints.

1 / 5

Progressive Disclosure

A short (<50-line) skill with no external references needed and none provided; header structure (Capabilities, Patterns, Anti-Patterns, Related) is reasonable, with the main gap being empty sections rather than poor navigation.

4 / 5

Total

8

/

20

Passed

Description

45%Weight 40%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 reads as a persona statement rather than a capability description: it conveys a viewpoint (design over implementation) but never states concrete actions or when to invoke the skill, and it omits the 'Use when' trigger that anchors the completeness rubric.

Suggestions

Rewrite the description as concrete actions in third person, e.g. 'Designs tool schemas and error-handling contracts for LLM function-calling and MCP tools.'

Add an explicit 'Use when...' trigger clause naming natural user phrases ('design a tool', 'tool schema', 'function calling', 'MCP', 'agent tool', 'tool causes hallucination or loops').

Tighten distinctiveness by foregrounding the schema/error-handling design niche versus generic api-designer or llm-architect skills.

DimensionReasoningScore

Specificity

Names the domain ('interface between LLMs and the outside world', tool design) but lists no concrete actions the skill performs; it describes a perspective ('the difference is almost always in the design') rather than actions.

2 / 5

Completeness

A clear 'what' is present (expert stance on tool design vs implementation) but there is no 'Use when...' trigger clause; per the rubric, a missing explicit trigger caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords exist ('LLMs', 'tools', 'agents', 'hallucinate, loop, or fail silently') but the natural user trigger phrases for this skill ('tool schema', 'function calling', 'MCP') are absent from the description.

3 / 5

Distinctiveness Conflict Risk

The agent/tool-design niche is somewhat specific, but the abstract phrasing and the body's own list of related skills (api-designer, llm-architect, backend) indicate real overlap risk with similar skills.

3 / 5

Total

11

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

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.