CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

toolhive-cli-user

Guide for using ToolHive CLI (thv) to run and manage MCP servers, skills, and AI-client plugins. Use when managing `thv ai-plugin` installs, project sync or upgrades, or plugin publishing for Claude Code or Codex; also use for MCP server and skill lifecycle commands. Covers server lifecycle, registries, secrets, client registration, builds, permissions, skills, and AI plugins. NOT for Kubernetes operator usage, ToolHive development/contributing, or general AI-client configuration unrelated to ToolHive.

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary reference-style skill: almost entirely executable commands, no filler or basic-concept explanations, explicit guardrails for destructive and trust-sensitive operations, and a well-structured two-file bundle with accurate one-level-deep anchored references. The only improvements are removing the Quick Start duplication with the Managing Servers section and making the implicit multi-step workflows (skill publishing, plugin install/sync) explicit numbered sequences.

DimensionReasoningScore

Conciseness

The body is dominated by terse, commented command blocks with almost no explanation of concepts Claude already knows, and dense high-value sections (error table, guardrails). It is not a 5 because of duplication — Quick Start repeats `thv list`, `thv status`, `thv stop`, `thv rm` verbatim from Managing Servers — and a few prose passages (AI Plugin Management) could be tightened.

4 / 5

Actionability

Nearly every section consists of copy-paste-ready commands with realistic flags and arguments (e.g., `thv run github --secret GITHUB_TOKEN,target=GITHUB_PERSONAL_ACCESS_TOKEN`, `thv run --from-config ./config.json`, `codex plugin install example-plugin@toolhive`), and the examples cover the common cases across all command families, matching the 5 anchor exactly.

5 / 5

Workflow Clarity

Sequences are clear within each task area (install → list → info → uninstall; validate → build → push), prerequisites are stated up front ("Requires `thv serve` to be running"), and validation/recovery exists (`thv skill validate`, `thv runtime check`, `ai-plugin sync --check`, `upgrade --preview`, the Error Handling table, and a guardrail requiring confirmation before destructive operations). It falls short of 5 because it is a command reference where multi-step workflows are implicit orderings rather than explicit step-by-step procedures with checkpoints.

4 / 5

Progressive Disclosure

SKILL.md is a clean overview that pushes full flag documentation to references/COMMANDS.md and detailed usage to references/EXAMPLES.md, both of which exist, are well-organized by sectioned anchors that all resolve (e.g., `#thv-run`, `#skill-commands`, `#ai-plugin-commands`), and contain no further nested references — exactly one level deep, clearly signaled per section and in a See Also list, matching the 5 anchor.

5 / 5

Total

18

/

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 well-crafted description that clearly states what the skill covers and when to use it, with concrete trigger phrases, tool synonyms, and explicit out-of-scope boundaries. The only soft spot is that the coverage list leans on domain nouns (registries, secrets, builds) rather than concrete verbs, which keeps specificity and trigger coverage a notch below the top anchors.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — "run and manage MCP servers, skills, and AI-client plugins", "plugin publishing", "project sync or upgrades" — plus a coverage list ("server lifecycle, registries, secrets, client registration, builds, permissions"). It falls short of the 5 anchor because many items are domain nouns rather than concrete actions, leaving minor gaps in action-level coverage.

4 / 5

Completeness

It explicitly answers both questions: the "what" ("Guide for using ToolHive CLI (thv) to run and manage MCP servers, skills, and AI-client plugins... Covers server lifecycle, registries, secrets, client registration, builds, permissions") and the "when" with concrete trigger phrases ("Use when managing `thv ai-plugin` installs, project sync or upgrades, or plugin publishing for Claude Code or Codex; also use for MCP server and skill lifecycle commands"). It also adds explicit negative scope ("NOT for Kubernetes operator usage..."), matching the 5 anchor.

5 / 5

Trigger Term Quality

Strong natural keyword coverage including synonyms ("ToolHive CLI (thv)") and domain terms users would actually say: "MCP server", "skill lifecycle", "ai-plugin installs", "plugin publishing", "Claude Code", "Codex". A few natural phrasings (e.g., "run an MCP server", "install a skill") appear only implicitly through the noun list, so it fits the 4 anchor (good coverage, a few natural terms missing) rather than comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — a specific CLI tool (thv/ToolHive) with distinct triggers — and the explicit exclusion clause ("NOT for Kubernetes operator usage, ToolHive development/contributing, or general AI-client configuration unrelated to ToolHive") actively prevents mis-triggering on adjacent skills, giving minimal conflict risk per the 5 anchor.

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

stacklok/toolhive

Path

skills/toolhive-cli-user/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.