CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-tool-builder

Tools are how AI agents interact with the world. A well-designed tool is the difference between an agent that works and one that hallucinates, fails silently, or wastes tokens. This skill covers tool design from schema to error handling.

Quality

57%

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 ./skills/agent-tool-builder/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%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 reasonably well-structured pointer skill with a genuine one-level-deep reference and clear mandatory-reading guidance, but it is held back by duplicated frontmatter text, a repetitive trigger list, and an unverified historical code sketch inlined in the body. The actionable procedure itself lives entirely in the reference, leaving the body's own executable guidance thin.

Suggestions

De-duplicate the intro: the first two paragraphs restate the frontmatter description; summarize in one line and move detail to the reference.

Move the 'Historical Python SDK sketch' (or its verified replacement) into references/detailed-guide.md, which already covers the tool-runner pattern, and keep only the safety caveat in the body.

Compress the 'When to Use' list into a single line of comma-separated triggers, and name the detailed guide's sections so 'load the relevant sections' is actionable.

DimensionReasoningScore

Conciseness

The body restates the frontmatter description almost verbatim ('Tools are how AI agents interact with the world...'), the 12-bullet 'When to Use' list repeats the identical phrase 'User mentions or implies:' twelve times where a comma list would do, and a 45-line 'Historical Python SDK sketch' is retained inline. Mostly efficient but includes unnecessary duplication that could be tightened — anchor 3; not anchor 4 because the duplication and repetitive list exceed 'minor instances of over-explanation'.

3 / 5

Actionability

The only code block is explicitly non-executable-in-practice: 'Mock only... Pin/verify SDK beta API and an account-accessible model before any billed call', and the real procedure is deferred ('Read [the detailed guide](references/detailed-guide.md) before executing this skill'). Some concrete guidance exists (the pointer plus a full code sketch) but it is unverified/historical and missing key details — anchor 3; not anchor 4 because the body itself offers no verified executable path.

3 / 5

Workflow Clarity

The single primary directive is unambiguous ('Read the detailed guide before executing this skill... for end-to-end work, read the guide completely'), but the body contains no sequenced procedure or validation checkpoints — the sequence lives entirely in the reference. Anchor 3 fits; not anchor 4 because there is no sequence of steps with checkpoints in the body, and not anchor 2 because the primary action is clearly and correctly stated.

3 / 5

Progressive Disclosure

The single reference is real (references/detailed-guide.md exists), well-signaled, and one level deep ('Read [the detailed guide](references/detailed-guide.md)... Treat its safety, prerequisites, and validation requirements as mandatory'), with guidance for focused vs. complete loading. Not anchor 5: the body inlines the 45-line historical SDK sketch that belongs in the reference (the guide already contains a tool-runner pattern), and 'load the relevant sections' does not name the guide's sections, leaving navigation slightly vague.

4 / 5

Total

13

/

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 has a clear domain focus and reads well, but it is padded with motivational fluff, states scope rather than concrete actions, and completely omits any 'Use when...' trigger guidance, capping completeness. It also misses the most common natural trigger terms for this domain such as 'function calling', 'MCP', and 'tool use'.

Suggestions

Add an explicit trigger clause, e.g., 'Use when the user mentions function calling, tool schemas, MCP servers/tools, or building tools for agents'.

Replace the motivational opening with concrete capabilities: 'Design tool JSON Schemas, write effective tool descriptions, implement validation and error handling, and build MCP tools'.

Include natural synonyms and technical terms users actually say — 'function calling', 'tool use', 'MCP', 'input_schema' — to improve trigger-term coverage.

DimensionReasoningScore

Specificity

Two of three sentences are motivational framing ('Tools are how AI agents interact with the world. A well-designed tool is the difference between an agent that works and one that hallucinates...'), and the only substance is a scope statement — 'This skill covers tool design from schema to error handling' — which names the domain and two topic areas but uses no concrete action verbs, matching anchor 2 ('Names the domain but actions are minimal or generic'). It falls short of anchor 3 because no concrete actions (e.g., 'write JSON Schemas', 'return informative errors') are explicitly stated.

2 / 5

Completeness

The 'what' is stated ('covers tool design from schema to error handling') but there is no 'Use when...' clause or equivalent trigger guidance anywhere, matching anchor 3 ('Has a clear what but when is missing') and hitting the judging guideline cap of 3. Not anchor 4 because the 'when' is entirely absent rather than merely under-specified.

3 / 5

Trigger Term Quality

Relevant keywords present ('tool', 'AI agents', 'tool design', 'schema', 'error handling') but major natural variations users say for this domain — 'function calling', 'MCP', 'tool use', 'input_schema' — are absent, matching anchor 3 ('Some relevant keywords but missing common variations or synonyms'). Not anchor 4 because the omissions are more than 'a few natural terms' for this domain.

3 / 5

Distinctiveness Conflict Risk

The niche (designing tools for AI agents) is somewhat specific, but generic phrases like 'tool design' and 'schema' could overlap with API-design, coding, and general tooling skills, matching anchor 3 ('Somewhat specific but could still overlap with similar skills'). Not anchor 4 because the trigger vocabulary is broad enough that minor-overlap-only would be too generous.

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.

Validation — 15 / 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

sickn33/agentic-awesome-skills

Path

skills/agent-tool-builder/SKILL.md

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.