CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

secrets

Connect external services and keep app credentials scoped. Use before adding an API key, OAuth connection, provider setup, or server-side request that needs a user's or workspace's credential.

Quality

85%

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.

A lean, well-structured policy skill: every token carries platform-specific rules Claude could not infer, anchored by a copy-paste-ready registration example and precise API names for credential resolution. The main gaps are the lack of concrete API guidance for the OAuth/connection-catalog paths and the absence of an end-to-end verification step in the workflow.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: it explains no general concepts (no OAuth primer, no library comparisons) and every sentence carries platform-specific policy Claude could not infer ("registerRequiredSecret", "resolveSecretDetailed()", tenancy restrictions on env keys). The dense env-key exception paragraph states four distinct rules (fallback permission, precedence, tenancy restriction, exception boundary) rather than padding, matching anchor 5 better than anchor 4, which would require trimmable over-explanation.

5 / 5

Actionability

The registration example is complete, copy-paste-ready TypeScript, and the resolve path names exact APIs ("use `resolveSecretDetailed()` from `@agent-native/core/server`", "Check `lookupFailed` before checking `value`"). However, the connection-catalog and OAuth paths provide no concrete API calls ("request the app grant and resolve its vault-backed credential reference through the workspace-connection API" names no function), and the resolve flow has no code example — minor gaps that fit anchor 4 rather than anchor 5's coverage of the common cases.

4 / 5

Workflow Clarity

"Choose the credential source" is a clear numbered 1-4 decision procedure followed by a register-then-resolve flow, with explicit error-handling checkpoints ("make a store failure retryable", "do not turn a failed lookup into a setup prompt", "redact provider responses before returning an error"). No destructive or batch cap applies. It fits anchor 4 rather than 5 because there is no end-to-end verification step and the register→resolve ordering is implied by section order rather than stated as a sequence.

4 / 5

Progressive Disclosure

This is a self-contained single-file skill with no bundle files, and nothing inlined here belongs in a separate file — all ~70 lines are core policy for this one task. Sections are cleanly headed (Rule / Choose the credential source / Register / Resolve / Related skills), references are nonexistent rather than buried or nested, and the "Related skills" section aids cross-navigation. There are no organizational gaps that would justify dropping to anchor 4.

5 / 5

Total

18

/

20

Passed

Description

78%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 that explicitly and concretely answers both what the skill does and when to use it, using natural trigger terms that map well to real user requests. The main weaknesses are that the capability statement stays at policy level rather than naming concrete operations, and a couple of common synonyms ("secret", "token") are missing from the trigger terms.

DimensionReasoningScore

Specificity

The description names its domain and two policy-level actions — "Connect external services" and "keep app credentials scoped" — but stops short of the skill's concrete operations (registering API keys, resolving credentials server-side). This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive): it lists fewer than the "several specific actions" of anchor 4, yet offers more than the minimal/generic action of anchor 2.

3 / 5

Completeness

"Connect external services and keep app credentials scoped" explicitly states the what, and "Use before adding an API key, OAuth connection, provider setup, or server-side request that needs a user's or workspace's credential" is an explicit when-clause with concrete trigger phrases. This matches anchor 5 exactly; anchor 4 would require the when to be less explicit or specific, which it is not.

5 / 5

Trigger Term Quality

"API key", "OAuth connection", "provider setup", and "credential" are natural phrases a user would say when needing this skill, giving good keyword coverage. Common synonyms such as "secret", "token", and "environment variable" are absent, which fits anchor 4 (a few natural terms missing) rather than anchor 5's comprehensive synonym coverage, while clearly exceeding anchor 3's sparser example ("Works with PDF files").

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — credential scoping for external service connections — with mostly distinct triggers ("API key", "OAuth connection", "provider setup"). Minor overlap risk remains with closely related security and backend skills via the broad trigger "server-side request that needs a user's or workspace's credential", fitting anchor 4 rather than anchor 5's minimal conflict risk.

4 / 5

Total

16

/

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

BuilderIO/agent-native

Path

.agents/skills/secrets/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.