CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

arkenv

Answer questions about ArkEnv and help implement environment variable validation. Use when developers: (1) Ask about environment variable validation or typesafety, (2) Want to setup ArkEnv in a project, (3) Need to define or update schemas using ArkType or Standard Schema, (4) Are integrating with Next.js, Nuxt, Vite, Bun, or Node.js runtimes. Triggers on: 'ArkEnv', 'env validation', 'typesafe env', 'createEnv', 'env.ts', 'arkenv'.

Quality

82%

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

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

The body delivers largely executable, well-organized guidance with an exemplary refusal-handling workflow, but it is a monolithic single-file skill: everything from the CLI reference to framework recipes is inlined, and Next.js/Nuxt lack the code examples the other frameworks get. Splitting detailed material into references/ files and sequencing the check command into a validation workflow would lift the two weakest dimensions.

Suggestions

Move the detailed material into references/ files (e.g. references/cli.md for the full init/check options and the refusal JSON envelope, references/frameworks.md for per-framework setup patterns) and keep SKILL.md as a lean overview with clearly signaled one-level-deep links.

Add executable setup examples for Next.js (@arkenv/nextjs) and Nuxt (@arkenv/nuxt) matching the quality of the Vite and Bun sections, since framework integration is a headline capability in the description.

Sequence the check command into the schema workflow with an explicit checkpoint (e.g. after defining/updating env.ts, run pnpm arkenv check --verify-example and fix reported diagnostics before integrating).

DimensionReasoningScore

Conciseness

The body is code-first and assumes Claude's competence (no padding explaining what Vite, Zod, or env validation are), with one-line intros per section. Minor over-explanation could be trimmed — e.g. the 26-line refusal JSON envelope could be reduced to its key fields, and phrases like "single canonical surface" are lightly marketing-flavored — matching 'efficient; minor instances of over-explanation' (anchor 4) rather than 'every token earns its place' (anchor 5).

4 / 5

Actionability

Most guidance is copy-paste ready: complete env.ts examples for ArkType, Zod, and Valibot, a consumption example, full vite.config.ts and bunfig.toml/Bun.build snippets, and concrete CLI invocations with flags. It falls short of anchor 5 because Next.js and Nuxt integration — two of the five advertised frameworks — are described in prose ("Build-time and runtime validation with automatic client/server isolation proxy") without any executable setup code, and the two-module secret recipe is sketched abstractly.

4 / 5

Workflow Clarity

The agent-init workflow is well sequenced with explicit validation ("Parse the JSON settlement envelope on stdout. Success is ok: true") and a genuine feedback loop for error recovery (inspect error.code and nextActions, only re-run with --force once deliberately decided safe). It stays at anchor 4 rather than 5 because the check command is documented as options only and never sequenced into a workflow (e.g. after defining a schema, run arkenv check to validate), leaving a checkpoint implicit.

4 / 5

Progressive Disclosure

The single 245-line SKILL.md has clear headers and easy navigation, but there are no bundle files at all: a full CLI reference, the complete refusal JSON envelope, and per-framework setup patterns are all inlined where references/ files would keep the overview lean. This matches 'some structure but could be better organized; content that should be separate is inline' (anchor 3); it is above anchor 2 because the inlined content is well sectioned, and below anchor 4 because nothing is split out — anchor 4 expects the bulk of detailed material in a separate file.

3 / 5

Total

15

/

20

Passed

Description

83%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: it states concrete capabilities, gives an explicit four-case 'Use when' clause, and closes with a dedicated trigger-term list. The main improvements are trimming the duplicated ArkEnv casing in favor of missing natural synonyms (.env, dotenv, zod env) and acknowledging the CLI/agent-setup capability that dominates the skill body.

DimensionReasoningScore

Specificity

Concrete actions are named ("Answer questions about ArkEnv and help implement environment variable validation") and the numbered use cases enumerate specific tasks ("setup ArkEnv in a project", "define or update schemas using ArkType or Standard Schema", "integrating with Next.js, Nuxt, Vite, Bun, or Node.js runtimes"). It lists several specific actions with minor gaps (CLI setup, hosting presets, the agent workflow are unmentioned), matching anchor 4 rather than 5, whose 'what' clause is more comprehensively enumerated.

4 / 5

Completeness

It explicitly answers both what ("Answer questions about ArkEnv and help implement environment variable validation") and when ("Use when developers: (1)... (2)... (3)... (4)..." plus "Triggers on: ..." with concrete trigger phrases). This clearly matches the anchor-5 example pattern of stating capabilities followed by an explicit 'Use when' clause with concrete triggers; it is not score 4 because the 'when' guidance is fully explicit, not merely present.

5 / 5

Trigger Term Quality

The explicit trigger list "'ArkEnv', 'env validation', 'typesafe env', 'createEnv', 'env.ts', 'arkenv'" covers natural phrasing and a common filename, but misses common synonyms and extensions users would say (.env, dotenv, zod env) and duplicates ArkEnv in two casings. This is good coverage with a few natural terms missing (anchor 4), not comprehensive synonym/extension coverage (anchor 5).

4 / 5

Distinctiveness Conflict Risk

The ArkEnv brand is named throughout, giving a clear niche, but generic-ish triggers like 'createEnv' (the t3-oss/env API name) and 'env.ts' create minor overlap risk with other env-validation skills (t3-env, dotenv-based tooling). That places it at 'mostly distinct; minor overlap risk with closely related skills' (anchor 4) rather than minimal conflict risk (anchor 5).

4 / 5

Total

17

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

onmax/nuxt-skills

Path

skills/arkenv/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.