CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-tools

Create tool configurations for a Sim integration by reading API docs

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/add-tools/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 content is a strong, highly actionable working manual: concrete templates, exact validation commands, explicit sequencing, and hard safety rules around unknown response schemas. Its weaknesses are length management — duplicated checklist rules and basic type glossary — and the absence of any progressive-disclosure structure for its very large surface area.

Suggestions

Move the Resolved Secrets and Provenance Boundaries section (and the file-handling detail) into a reference file (e.g. references/provenance.md) with a one-paragraph summary and clearly signaled links in SKILL.md.

Cut the "Checklist Before Finishing" duplication by referencing the in-section rules once, and drop the basic type glossary ("'string' - Text values", "'number' - Numeric values") that Claude already knows.

Add one complete worked example of a real service tool (config, types, registry entry, block wiring) so the placeholder templates have a concrete end-to-end model.

DimensionReasoningScore

Conciseness

Most of the body is dense, non-derivable project-specific rule (boundary checks, provenance handling, executor caps) that earns its tokens, but there is genuine slack: a basic type glossary ("'string' - Text values"), a redundant "Required vs Optional" bullet pair, a "Checklist Before Finishing" that restates rules already stated verbatim, and a ~60-line provenance section of near-impenetrable prose. This fits "mostly efficient but includes some unnecessary explanation or could be tightened" rather than the noticeably-verbose anchor, since little of the content explains concepts Claude already knows.

3 / 5

Actionability

Concrete, near-executable guidance throughout: full TypeScript config templates, exact commands ("bun run generate:tool-metadata", "bun run check:tool-param-reachability"), precise file paths, and step-by-step block wiring code. It falls short of fully copy-paste ready because the templates use unsubstituted placeholders ({ServiceName}{Action}Params) and there is no complete worked example of one real tool end-to-end.

4 / 5

Workflow Clarity

A clear end-to-end sequence (read docs → scaffold directories → write configs → register → regenerate metadata → wire the block → validate) is capped with an explicit "Final Validation (Required)" section of cross-reference checkpoints, two checklists, and error-escalation paths for unknown schemas (ask the user, use only documented endpoints, or stop and say why). This matches the anchor for explicit validation steps, feedback loops, and checklists.

5 / 5

Progressive Disclosure

The body is well-sectioned with descriptive headers, but it is a ~630-line monolith with no bundle files: dense, self-contained sections (Resolved Secrets and Provenance Boundaries, File Downloads) clearly belong in one-level-deep reference files, and its cross-references point to repo paths outside the skill bundle. This fits "some structure but content that should be separate is inline"; it is not a 2 because navigation within the file is good and references that do exist are clearly signaled.

3 / 5

Total

15

/

20

Passed

Description

53%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 states a clear, domain-specific capability but provides no usage triggers, so it reads as a half-complete description. Its distinctiveness within the Sim ecosystem is decent, though it would benefit from natural trigger phrasing. It lands just above the midpoint of the scale.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user asks to add tools for a service, integrate an external API into Sim, or create tool configs from API documentation."

Include natural user phrasings and synonyms as trigger terms — "add tools", "integrate a service", "connect an API", "tool config" — so the skill triggers on how users actually ask.

Briefly name the concrete deliverables (typed tool files, registry entry, block wiring) to raise specificity beyond a single action.

DimensionReasoningScore

Specificity

"Create tool configurations" is a concrete action and "for a Sim integration by reading API docs" names the domain and method, but only one core action is described — matching the anchor for a domain plus 1-2 concrete actions without comprehensive coverage. It is not a 4 because it omits several specific capabilities (param typing, registry, block wiring) that the skill actually performs.

3 / 5

Completeness

The "what" is clear ("Create tool configurations for a Sim integration by reading API docs") but there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It fits the anchor "has a clear 'what' but 'when' is missing" exactly, and is not a 4 because the 'when' is entirely absent rather than weakly implied.

3 / 5

Trigger Term Quality

Relevant keywords exist ("tool configurations", "Sim integration", "API docs") but common natural phrasings users would say are missing, such as "add tools for a service", "integrate a service", or "connect an API". Not a 2 since the terms present are domain-specific rather than entirely generic; not a 4 because the natural variations and synonyms are absent.

3 / 5

Distinctiveness Conflict Risk

"Sim integration" tool configuration is a specific niche with distinct triggers, giving minimal conflict risk with generic skills. It is not a 5 because the phrasing could still overlap with sibling skills in the same Sim repository (e.g., migration or registry-boundary skills) without a clearer discriminator.

4 / 5

Total

13

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (649 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

simstudioai/sim

Path

.agents/skills/add-tools/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.