arkenv — Claude Code skill: env validation setup
Helps configure ArkEnv, define typed environment schemas, and add validation to JavaScript and TypeScript projects.
no license 282 installs ★ 730 updated 2026-11-02
npx skills add onmax/nuxt-skills --skill arkenv -a claude-codeWhat arkenv does
This skill guides ArkEnv setup for typed environment checks. It can help create env.ts, choose ArkType or Standard Schema, and use one env import throughout frontend and backend code.
It covers Next.js, Nuxt, Vite, Bun, and Node.js integrations. The Vite and Bun plugins inline public values while guarding server-only secrets; Next.js and Nuxt use client/server isolation. The CLI can detect the framework, scaffold the schema, configure tsconfig.json, and apply a hosting preset.
For agent-driven setup, use pnpm dlx arkenv init --agent. Its JSON result exposes success or refusal details through error.code and nextActions. Schema discovery follows env.ts, src/env.ts, or an explicit --schema path, so custom locations need that flag.
What it helps with
- validate environment variables against a schema
- scaffold
env.tsin a new project - define values with ArkType or Zod
- keep public values separate from server secrets
- configure ArkEnv for Next.js or Nuxt
Example prompts for the agent
- Set up ArkEnv in this project and create the schema at
src/env.ts. - Run
pnpm arkenv check --schema src/env.tsand explain any environment errors. - Configure ArkEnv for Vite so client code cannot read server-only keys.
How to install arkenv
1Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill arkenv -a claude-code2Manually: put the files in place
~/.claude/skills/arkenv/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/arkenv/
1Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill arkenv -a codex2Manually: put the files in place
.agents/skills/arkenv/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill arkenv -a cursor2Manually: put the files in place
.cursor/skills/arkenv/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install onmax/nuxt-skills skills/arkenv2Manually: put the files in place
.github/skills/arkenv/SKILL.md1Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill arkenv -a gemini-cli2Platform CLI
gemini skills install https://github.com/onmax/nuxt-skills --path skills/arkenvManually: put the files in place
.devin/skills/arkenv/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill arkenv -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about arkenv
How do I install arkenv in Claude Code?
Run npx skills add onmax/nuxt-skills --skill arkenv -a claude-code, then check ~/.claude/skills/arkenv/SKILL.md.
What does arkenv do?
The skill helps set up ArkEnv and validate environment variables through typed schemas. It covers ArkType, Standard Schema, Zod, and Valibot.
How does the arkenv CLI discover a schema file?
It uses --schema or the convention paths env.ts and src/env.ts. A package.json arkenv field is not used for schema discovery.