CtrlK
BlogDocsLog inGet started
Tessl Logo

env-manager

Use when the user provides API keys, tokens, or other configuration values that should persist across sessions, or when the user asks to query, list, or delete saved environment variables. Manages personal env by default and workspace env only when explicitly requested.

72

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

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with executable snippets and clear per-operation steps, but pays a large conciseness penalty for bilingual duplication and repeated per-scope code variants, and keeps everything in one long monolithic file with no progressive disclosure.

Suggestions

Drop the Chinese comment blocks (or move them to a separate localized reference) so the English body is not duplicated token-for-token.

Collapse the seven near-identical set/get/list/unset snippets into one canonical example plus a short note showing how 'scope' differs, rather than a full snippet per scope.

Since there are no bundle files, either trim the body under ~50 lines of well-organized sections to qualify for the simple-skill carve-out, or split the per-operation reference into a single referenced file.

DimensionReasoningScore

Conciseness

Every section is duplicated in Chinese comment blocks alongside English, and seven near-identical code snippets repeat per-scope variants, roughly doubling token cost without adding capability.

2 / 3

Actionability

Each operation ships an executable run_sdk_snippet with real tool names, key/scope parameters, and consistent error handling (raise SystemExit on result failure) — copy-paste ready.

3 / 3

Workflow Clarity

A simple single-action-per-call skill whose per-operation steps are unambiguous; no destructive batch flow is present, so the simple-skill carve-out applies and the steps are clear.

3 / 3

Progressive Disclosure

No bundle files exist, yet the body is a ~200-line monolith with all seven scope variants inline rather than organized with one-level-deep references or de-duplicated guidance.

2 / 3

Total

10

/

12

Passed

Description

100%

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 concise, well-targeted description that explicitly states both capabilities and use-when triggers with concrete CRUD verbs and natural keywords. The personal-vs-workspace default rule adds useful distinctiveness without verbosity.

DimensionReasoningScore

Specificity

Names concrete actions ('query, list, or delete saved environment variables', 'persist across sessions') and specific scopes (personal vs workspace), covering the full CRUD lifecycle.

3 / 3

Completeness

Answers both what ('Manages personal env by default and workspace env only when explicitly requested') and when ('Use when the user provides API keys... or asks to query, list, or delete') with an explicit Use-when clause.

3 / 3

Trigger Term Quality

Natural user-facing terms are well covered: 'API keys, tokens', 'configuration values', 'query, list, or delete', 'environment variables' — the words a user would actually say.

3 / 3

Distinctiveness Conflict Risk

Scoped to persisted environment-variable management with a clear personal/workspace distinction and concrete triggers, making it unlikely to fire for unrelated skills.

3 / 3

Total

12

/

12

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.

Validation15 / 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
dtyq/magic
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.