CtrlK
BlogDocsLog inGet started
Tessl Logo

discover-and-wire-tools

Use find_capabilities to discover the right Agenta tools for an agent you are building, report what each integration needs to connect, and wire the tools into the new agent's config. Use when a setup/builder agent must turn a plain-language task ("post to Slack and open GitHub issues") into attached, connected, ready-to-run tools.

70

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

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.

A well-structured, highly actionable skill body: a concrete discover->resolve->create->test loop with explicit validation checkpoints and an error-recovery feedback loop, plus executable call examples. The only notable weakness is the dated availability blockquote, which dents conciseness per the time-sensitive-content guideline.

Suggestions

Move the 'Availability (2026-06-27)' note (date + SDK-not-yet-declared status) into a clearly marked 'Status / not yet available' or deprecated-style section so the dated, version-specific detail does not penalize conciseness.

Once the SDK declares find_capabilities as a callable tool, prune the workaround endpoints (POST /tools/discover, POST /tools/call) or relocate them to a fallback section to keep the main flow lean.

DimensionReasoningScore

Conciseness

The body is mostly lean and operational (bullet glossaries, a concrete loop, a jsonc call), but the 'Availability (2026-06-27)' blockquote carries time-sensitive date/version detail not housed in a deprecated/old-patterns section, which the guidelines penalize; not score 3 because of that dated content, not score 1 because it never pads with concepts Claude already knows.

2 / 3

Actionability

Provides fully executable guidance — a real find_capabilities({use_cases}) payload plus concrete HTTP endpoints ('POST /tools/discover' with {"use_cases":[...]}, 'POST /tools/connections/' with a body) and specific field references; not score 2 because it is copy-paste ready, not pseudocode.

3 / 3

Workflow Clarity

Sequences a clear 'discover -> resolve-connections -> create -> test' loop with numbered steps, explicit checkpoints ('re-run find_capabilities... to confirm ready', 'Always check connection.state before assuming a tool will run'), and a recovery feedback loop ('If a tool call fails on a missing connection, return to step 3'); not score 2 because validation checkpoints and the error loop are explicit.

3 / 3

Progressive Disclosure

No bundle files exist, so the skill is appropriately self-contained; it is well-organized into clearly headed sections with no nested/deep references and no monolithic wall of text; not score 2 because nothing here clearly belongs in a separate file — the dense material is integral to the operational loop.

3 / 3

Total

11

/

12

Passed

Description

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that concretely names three actions and pairs them with an explicit 'Use when' trigger, giving it high completeness and distinctiveness. Its main weakness is trigger-term quality: the natural user phrasing is limited to one example while the rest leans on product-specific jargon.

Suggestions

Broaden natural trigger terms beyond the single example — e.g. 'connect integrations', 'set up tools', 'wire up Slack/GitHub' — so the description matches more varied user phrasings.

Consider softening the jargon-heavy trigger clause ('setup/builder agent must turn a plain-language task') with plainer language a user would actually say.

DimensionReasoningScore

Specificity

Lists three concrete actions — 'discover the right Agenta tools', 'report what each integration needs to connect', and 'wire the tools into the new agent's config' — matching the 'multiple specific concrete actions' anchor; it is not score 2 because the actions are distinct and complete rather than partial.

3 / 3

Completeness

Explicitly states what it does (discover/report/wire tools) and when to use it via an explicit 'Use when a setup/builder agent must turn a plain-language task... into attached, connected, ready-to-run tools' trigger; not score 2 because the 'when' is explicit, not merely implied.

3 / 3

Trigger Term Quality

Includes one natural user phrase ('post to Slack and open GitHub issues') but the surrounding trigger language is domain jargon ('setup/builder agent', 'find_capabilities', 'plain-language task'), so it has some relevant keywords but misses common variations; not score 3 because coverage of natural terms is narrow.

2 / 3

Distinctiveness Conflict Risk

Occupies a clear niche (Agenta tool discovery + wiring via find_capabilities for builder agents) with a distinct trigger unlikely to fire for unrelated skills; not score 2 because the trigger is specific enough to avoid overlap with generic tool skills.

3 / 3

Total

11

/

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
Agenta-AI/agenta
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.