CtrlK
BlogDocsLog inGet started
Tessl Logo

add-hosted-key

Add hosted API key support to a tool so Sim provides the key (metered and billed to the workspace) when a user has not brought their own. Use when adding a `hosting` config to a tool under `apps/sim/tools/{service}/`.

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

Low

Low-risk findings worth noting

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 thorough, highly actionable skill body with concrete code, file paths, and a well-sequenced workflow capped by a checklist. The only real drag is mild redundancy in the getCost examples that inflates length without adding information.

Suggestions

Consolidate the three near-identical getCost code blocks (main hosting example plus the 'reports cost' and 'does not report cost' variants) into one parameterized example to reduce redundancy.

Consider extracting the longer reference-implementation details (Exa/Google Maps line references) into a references file once the skill grows, keeping the main body lean.

DimensionReasoningScore

Conciseness

Dense with non-obvious domain knowledge (env var conventions, duplicate apiKey subblock pattern, rate-limiter modes) but the getCost example appears in near-duplicate across the main hosting block and both 'when the API reports/does not report cost' variants, so it could be tightened.

2 / 3

Actionability

Provides specific file paths, copy-paste-ready TypeScript snippets, a real env var layout, and concrete block-config examples — fully executable guidance.

3 / 3

Workflow Clarity

Clear 6-step sequence with an overview table, explicit ordering ('Before writing any getCost or rateLimit code, look up docs'), validation guards ('getCost must always throw'), and a comprehensive final checklist.

3 / 3

Progressive Disclosure

No bundle files exist, but the single file is well organized into an overview table, numbered per-step sections, and a checklist, satisfying the well-organized-sections allowance for reference-free skills.

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, well-scoped description with explicit 'Use when' triggers and concrete capability areas. Its main weakness is reliance on internal jargon/code identifiers as trigger terms rather than natural user language.

Suggestions

Replace or supplement the internal identifier 'hideWhenHosted' with a natural phrase such as 'hiding the API key field when hosted' so users are more likely to trigger the skill in plain language.

Add common user phrasings like 'bring your own key' spelled out alongside the BYOK abbreviation to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

Names multiple concrete capabilities ('Add hosted API key support', 'BYOK support', 'hideWhenHosted', 'hosted key pricing') rather than a single vague action, matching the multi-action score-3 anchor.

3 / 3

Completeness

Explicitly answers both what ('Add hosted API key support to a tool so Sim provides the key') and when ('Use when adding hosted keys, BYOK support...'), satisfying the explicit-trigger bar.

3 / 3

Trigger Term Quality

Includes relevant terms ('hosted keys', 'BYOK') but leans on internal code identifiers like 'hideWhenHosted' that a user would not naturally say, missing common phrasings.

2 / 3

Distinctiveness Conflict Risk

Occupies a clear niche (hosted key provisioning) with distinct triggers unlikely to fire for unrelated 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
simstudioai/sim
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.