CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-tavily-tool

Add Tavily Search and Extract as keyless remote MCP tools for selected NanoClaw agent groups. Use when installing Tavily web search or URL extraction without an API key.

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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.

A highly actionable, well-sequenced operational skill with strong validation checkpoints and error-recovery guidance. Its weaknesses are duplicated upgrade-path explanation between Phase 5 and the Keyless limit section, and bundle-referenced files that are not present to verify.

Suggestions

Consolidate the upgrade-flow detail: the "Keyless limit" section re-explains Phase 5's attach-secret/re-register mechanics; keep only the runtime behavior there and point back to Phase 5.

Break the multi-clause sentences in Phase 5 steps 3–4 (template substitution, block replacement, CLAUDE.md warning) into discrete numbered sub-steps so each operation is scannable.

Ensure upgrade-instructions.md, REMOVE.md, and tavily-manifest.test.ts are actually shipped in the skill bundle so the body's links and cp source path resolve.

DimensionReasoningScore

Conciseness

The body is mostly dense project-specific detail, but the "Keyless limit" section re-explains the full Phase 5 upgrade mechanism (attach-secret, gateway injection, re-registration) that Phase 5 already covers, and Phase 5 steps 3–4 pack multiple operations into single over-long sentences. Not a 4: the duplication and run-on sentences go beyond 'minor trimming'; not a 2: there is no generic padding or explanation of concepts Claude already knows.

3 / 5

Actionability

Fully executable throughout: exact grep/cp/vitest commands, the complete JSON manifest entry, and the full `ncl groups config add-mcp-server` invocation with every arg and header pair, plus concrete verification commands (`ncl groups config get`, `docker inspect ... | grep '^APP_URL='`). Common failure cases are covered in Troubleshooting with specific fixes.

5 / 5

Workflow Clarity

Five clearly sequenced phases with explicit validation checkpoints: the manifest guard test in Phase 2, approval-gating semantics explained in Phase 3 ("approval-pending immediately; that is not an error"), config inspection plus agent response check in Phase 4, and a gateway precheck with a defined fallback in Phase 5. Troubleshooting provides feedback loops (rebuild, restart, restore ignore-tool pairs) for the listed failure modes.

5 / 5

Progressive Disclosure

Good structure: the body stays a procedural overview while the upgrade template ([upgrade-instructions.md](upgrade-instructions.md)) and removal procedure ([REMOVE.md](REMOVE.md)) are split out one level deep with clearly signaled links, and the keyless-limit/troubleshooting sections are cross-linked. Not a 5: the referenced bundle files (upgrade-instructions.md, REMOVE.md, tavily-manifest.test.ts) are not present in the bundle as provided, so navigation to them cannot be verified.

4 / 5

Total

17

/

20

Passed

Description

87%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.

A strong description: third person, concise, and explicit about both capability and trigger conditions. It names the concrete tools, mechanism, and target while providing natural trigger phrases, with only minor coverage gaps.

DimensionReasoningScore

Specificity

Names several concrete, specific actions — "Add Tavily Search and Extract as keyless remote MCP tools for selected NanoClaw agent groups" specifies two named tools, the keyless mechanism, and the target (agent groups). Not a 5 because it omits parts of the skill's coverage (bridge install, upgrade path, removal), leaving minor gaps.

4 / 5

Completeness

Explicitly answers both: what ("Add Tavily Search and Extract as keyless remote MCP tools for selected NanoClaw agent groups") and when ("Use when installing Tavily web search or URL extraction without an API key"), with concrete trigger phrases. Clear fit for the top anchor; a 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

"Use when installing Tavily web search or URL extraction without an API key" covers natural trigger phrases users would say: "installing", "Tavily", "web search", "URL extraction", "without an API key". Not a 5 because common synonyms like "scrape/fetch this URL" or "add search to my agents" are absent.

4 / 5

Distinctiveness Conflict Risk

"Tavily" and "NanoClaw agent groups" establish a clear niche with distinct triggers; the keyless/MCP framing further narrows it. Minimal risk of triggering for the wrong skill.

5 / 5

Total

18

/

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

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

nanocoai/nanoclaw

Path

.claude/skills/add-tavily-tool/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.