add-hosted-key

Add hosted API key support to a tool so Sim provides the key when users don't bring their own. Use when adding hosted keys, BYOK support, hideWhenHosted, or hosted key pricing to a tool or block.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

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

This is a highly actionable, well-sequenced procedural skill with copy-paste code and a closing checklist. The only soft spot is conciseness/progressive disclosure: it is a long single-file guide whose rationale prose could be tightened or partly externalized.

Suggestions

Tighten the Step 2 rate-limit rationale and the Step 6 summary spec into scannable bullets; the key-pooling math can be shortened to the conservative-default rule.

Consider moving the extended pricing/rate-limit reference material (Exa/Google Maps patterns, full getCost variants) into a references file linked from SKILL.md to reduce inline length and improve progressive disclosure.

Drop the generic 'good when the API charges flat per-request' explanations where the code example already conveys the intent.

Dimension	Reasoning	Score
Conciseness	The body is dense and mostly project-specific (rate-limiter modes, getCost conventions, the duplicate apiKey pattern) that earns its place, but several rationale paragraphs (key-pooling math, the 6-point summary spec) could be trimmed without losing actionability.	4 / 5
Actionability	Every step ships copy-paste-ready TypeScript with real field names (BYOKProviderId, hosting config, getCost, transformResponse, hideWhenHosted, the duplicate apiKey pattern, PROVIDERS entry), covering the common cases fully.	5 / 5
Workflow Clarity	A clear 6-step sequence is previewed in an overview table, front-loaded with a research-before-code checkpoint, guarded by runtime validation ("getCost must always throw"), and capped with a verification checklist.	5 / 5
Progressive Disclosure	Sections are well organized with clear headers and the reference implementations are cited by file path rather than duplicated, but the guide is a single ~290-line file with no one-level-deep references, so the simple-skill exception to reach 5 does not apply.	4 / 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.

The description cleanly answers both what the skill does and when to use it, with concrete scope and a niche that won't collide with other skills. Trigger terms are strong for the intended audience, with only minor reliance on codebase-internal jargon.

Dimension	Reasoning	Score
Specificity	Names the concrete action ("Add hosted API key support to a tool so Sim provides the key") and enumerates specific scope items (hosted keys, BYOK support, hideWhenHosted, hosted key pricing), giving several concrete actions with only minor coverage gaps.	4 / 5
Completeness	Clearly states what the skill does ("Add hosted API key support to a tool so Sim provides the key when users don't bring their own") and gives an explicit "Use when..." clause with concrete triggers, answering both what and when.	5 / 5
Trigger Term Quality	"Use when adding hosted keys, BYOK support, hideWhenHosted, or hosted key pricing" provides good keyword coverage a developer in this codebase would naturally say, though hideWhenHosted is internal jargon rather than a user-natural phrase.	4 / 5
Distinctiveness Conflict Risk	Targets a narrow, Sim-specific niche (hosted keys, BYOK, hideWhenHosted) with distinct triggers, making conflict with other skills minimal.	5 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: simstudioai/sim
Path: .cursor/skills/add-hosted-key/SKILL.md
Commit: 417ae20

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.