Agent skill

The Voice

by yamcodes in yamcodes/arkenv

Rewrite ArkEnv docs and site copy in the product voice: Turbo-shaped what/why/how, not skinny command lists and not marketing hype.

MITAuto-check passedDevelopment

Install The Voice

skills CLI
$ npx skills add yamcodes/arkenv --skill the-voice -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install yamcodes/arkenv the-voice --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/yamcodes/arkenv.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/the-voice .claude/skills/the-voice && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
the-voice
GitHub stars
145
Token cost
~1.1k tokens
SKILL.md length
560 words
Files
3 (incl. references)
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

Rewrite ArkEnv docs and site copy in the product voice: Turbo-shaped what/why/how, not skinny command lists and not marketing hype.

  • Works in 4 steps: Name the ecosystem thing (plugins,… → Say what ArkEnv provides and why. → Show the command or snippet. → …
  • The user says fix the voice
  • SKILL.md covers What "fix the voice" means, House terms, Install fences and Not this voice, plus 1 more section
  • Calls npm, npx and pnpm

What it does

The Voice is an agent skill from yamcodes/arkenv. Rewrite ArkEnv docs and site copy in the product voice: Turbo-shaped what/why/how, not skinny command lists and not marketing hype. Use when the user says "fix the voice", "/the-voice", "too skinny", "too terse", "needs meat", "match turborepo", or when writing, reviewing, or editing docs/MDX/homepage copy — even if they did not name this skill. Prefer this over docs-writer for register; keep docs-writer for links and wrapping. Use fumadocs <Callout for forks and defaults.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/canons.md` and `references/examples.md`).

It sits in Development, covering Monorepo tooling and Markdown. It works with Turborepo. The repository describes itself as: ⛯ Typesafe environment variables with ArkType, Zod, or Valibot. The licence is MIT.

When your agent uses it

  • The user says fix the voice
  • Match turborepo
  • Editing docs/MDX/homepage copy — even if they did not name this skill

Example prompts

  • “fix the voice”
  • “/the-voice”
  • “too skinny”
  • “/the-voice”

Requirements

  • Node.js

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Name the ecosystem thing (plugins, skills) and what it is made of.
  2. Say what ArkEnv provides and why.
  3. Show the command or snippet.
  4. Bullet what it teaches or enables, not only what it runs.

What it can do on your machine

Read from SKILL.md and the folder at commit 50d0325. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • npx
    • pnpm
    • yarn
    • bun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • turborepo.dev

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

The Voice loads about 1.1k tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 123 tokens; SKILL.md has 560 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~123
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from yamcodes/arkenv at commit 50d0325, republished under its MIT licence (© yamcodes). 560 words, ~1,120 tokens.

Download SKILL.mdSave it as .claude/skills/the-voice/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
the-voice
description
Rewrite ArkEnv docs and site copy in the product voice: Turbo-shaped what/why/how, not skinny command lists and not marketing hype. Use when the user says "fix the voice", "/the-voice", "too skinny", "too terse", "needs meat", "match turborepo", or when writing, reviewing, or editing docs/MDX/homepage copy — even if they did not name this skill. Prefer this over docs-writer for register; keep docs-writer for links and wrapping. Use fumadocs `<Callout>` for forks and defaults.
metadata.author
Yam Borodetsky
metadata.internal
true

The voice

ArkEnv docs sound like turborepo.dev plus the pages already in that register: getting-started, Introduction, Installation, Community, and a framework guide (for example Vite). docs-writer is Gemini CLI boilerplate for mechanics. This skill is the register. stop-slop cuts AI tells after the meat is in; it must not strip why.

Read references/canons.md before rewriting a page. Read references/examples.md when the task is a voice pass (the AI guide is the worked example).

What "fix the voice" means

Rewrite how the page sounds. Keep facts, IA, APIs, and deep-link headings unless the user also asked to change those.

Each section needs what, why, and how. Skinny pages fail on what/why ("do this, do that"). Inflated pages fail by dumping internals (marketplace.json, diagnostic field lists) that belong in reference.

A good H2 starts in the reader's world, then what ArkEnv provides. Do not open with "@scope/pkg is the [category noun]" unless the page is API reference.

  1. Name the ecosystem thing (plugins, skills) and what it is made of.
  2. Say what ArkEnv provides and why.
  3. Show the command or snippet.
  4. Bullet what it teaches or enables, not only what it runs.

Pick a default path. Fallbacks are "instead," not "or also." Put that fork in a fumadocs <Callout> (usually type="info" with a title), not a body sentence. Match apps/www/content/docs/core-concepts/defining-your-schema.mdx (title="Already on ArkType?"). Use warn / error for risk, not for navigation. Do not use GitHub > [!NOTE] alerts on the docs site.

The page lead is two sentences, product name in both, like Turbo:

Turborepo is designed to work seamlessly with AI coding assistants. Turborepo provides features that help AI understand your repository and work more efficiently.

Do not open with commands, "It gives them…", or a feature list. Name the outcome; let H2s name the features. Keep "seamlessly" in this cadence. stop-slop must not flatten that lead.

Show full SKILL.md (252 more words)Show less

House terms

  • Typesafe (one word), not "Type-safe".
  • Headings and SEO: "environment variables". Body: "env vars" is fine.
  • "Zero runtime dependencies" only for @arkenv/core (peer arktype) and @arkenv/standard. Never "zero dependencies" for the CLI or plugins.
  • Nub is a real Node runner. Do not "correct" it to Bun.
  • Address the reader as you. Present tense, contractions, US English. No "please", no Latin abbreviations in running copy, no anthropomorphism.

Install fences

Commands the reader runs (init, npm install, npx …) use fumadocs package-install fences, not bash. Author npm form only: npx … or npm install …. Never npm i, pnpm add, yarn add, bun add, or nub add in the source. The site tabs the other managers (including Nub as nubx / nub add). See apps/www/content/docs/frameworks/nextjs.mdx and apps/www/lib/package-install-fences.test.ts.

Leave bash for non-install shell (git, curl, file copies) and for Nub-only runner examples that are not package-install tabs. Leave json MCP configs as JSON even if a field is "npx". Prompt fences stay text.

Not this voice

SurfaceVoice
CHANGELOG.md / changesetsUser-facing past tense ("The plugin now…"), not imperatives
Boundary access errorsNext.js taint string; do not restyle
Hallmark / UIVisual register, not docs prose
Prompts inside fenced textAgent instructions; leave them tight

Workflow

  1. Load the canons, then the target page.
  2. Diagnose: skinny, stuffed, slop, or wrong surface.
  3. Rewrite in the Turbo H2 shape. Add why with product facts, not filler. Do not invent features to add meat.
  4. Point at reference for shapes, flags, and APIs.
  5. Pass stop-slop without deleting the why bullets.

© yamcodes, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/the-voice of yamcodes/arkenv.

  • SKILL.md
  • references/canons.md
  • references/examples.md

Open the folder on GitHubat commit 50d0325

Compare with similar skills

The Voice next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

The Voice compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
The Voice this skillyamcodes/arkenv145—~1.1kAutomated safety check: PassMIT
Monorepo Managementgluestack/gluestack-ui5.3k12 repos~3.2kAutomated safety check: WarnNone
TS SDK Authormindfold-ai/Trellis15k—~6.1kAutomated safety check: PassMIT
Turborepo Cachingwshobson/agents40k9 repos~2kAutomated safety check: NotesMIT
TurborepoJetBrains/skills36620 repos~6.7kAutomated safety check: NotesMIT
Turborepo WorkflowChatbotXIO/ChatbotX881—~880Automated safety check: NotesCustom licence

Similar skills

  • Monorepo Management

    gluestack/gluestack-ui

    Master monorepo management with Turborepo, Nx, and pnpm workspaces to build efficient, scalable multi-package repositories with optimized builds and dependency management.

    5.3k GitHub starsUsed in 12 repos~3.2k tokens
    DevelopmentAuto-check: warnings
  • TS SDK Author

    mindfold-ai/Trellis

    Design, build, verify, and publish production-grade TypeScript SDKs as npm packages inside a pnpm monorepo.

    15k GitHub stars~6.1k tokensUpdated 9 days ago
    DevelopmentAuto-check passed
  • Turborepo Caching

    wshobson/agents

    Configures Turborepo pipelines and local or remote caching for monorepo builds, including Vercel remote cache, a self-hosted cache and cache-miss debugging.

    40k GitHub starsUsed in 9 repos~2k tokens
    DevelopmentAuto-check: notes
  • Turborepo

    JetBrains/skills

    Official

    Turborepo monorepo build system guidance. An agent skill from JetBrains/skills.

    366 GitHub starsUsed in 20 repos~6.7k tokens
    DevelopmentAuto-check: notes
  • Turborepo Workflow

    ChatbotXIO/ChatbotX

    Manage turborepo monorepo development workflow including dev servers, builds, linting, and package management.

    881 GitHub stars~880 tokensUpdated today
    DevelopmentAuto-check: notes
  • Monorepo Architect

    davila7/claude-code-templates

    Expert in monorepo architecture, build systems, and dependency management at scale.

    32k GitHub starsUsed in 8 repos~542 tokens
    DevelopmentAuto-check passed

More from yamcodes/arkenv

All 20 skills in this repo
  • Hallmark

    yamcodes/arkenv

    Anti-AI-slop design skill for greenfield pages, audits, redesigns, and design extraction from URLs or screenshots.

    145 GitHub starsUsed in 4 repos~18k tokens
    Auto-check passed
  • Bulletproof React

    yamcodes/arkenv

    Bulletproof React architecture patterns for scalable, maintainable applications.

    145 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Arkenv

    yamcodes/arkenv

    Answer questions about ArkEnv and help implement environment variable validation.

    145 GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Code Review

    yamcodes/arkenv

    Fetch, analyze, and address code reviews and comments on GitHub, or perform a code review on changes in the workspace.

    145 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Forward Port

    yamcodes/arkenv

    Manually forward-ports merged dev (v0) changes to the v1 branch, adapting code to v1's package layout and changeset names.

    145 GitHub stars~970 tokensUpdated today
    Auto-check passed
  • Groom Issue

    yamcodes/arkenv

    Groom a poorly written issue by grilling the user to clarify requirements, updating the issue on GitHub via the gh cli, and utilizing the triage skill to apply the correct label and add an agent…

    145 GitHub stars~1k tokensUpdated today
    Auto-check passed

Works with

Questions about The Voice

What does The Voice do?

Rewrite ArkEnv docs and site copy in the product voice: Turbo-shaped what/why/how, not skinny command lists and not marketing hype. The Voice is an agent skill from yamcodes/arkenv. Rewrite ArkEnv docs and site copy in the product voice: Turbo-shaped what/why/how, not skinny command lists and not marketing hype.

When should I use The Voice?

The Voice fits situations like: the user says fix the voice; match turborepo; editing docs/MDX/homepage copy — even if they did not name this skill.

How do I install The Voice in Claude Code?

Run `npx skills add yamcodes/arkenv --skill the-voice -a claude-code`. Or copy the skill folder (skills/the-voice in yamcodes/arkenv) into .claude/skills/the-voice in your project. Claude Code loads it when a task matches its description.

How do I install The Voice in Codex?

Run `npx skills add yamcodes/arkenv --skill the-voice -a codex`. Or copy the skill folder (skills/the-voice in yamcodes/arkenv) into .agents/skills/the-voice in your project. Codex loads it when a task matches its description.

Can I use The Voice in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yamcodes/arkenv --skill the-voice -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/the-voice, .gemini/skills/the-voice, .github/skills/the-voice and .opencode/skills/the-voice in your project.

What does The Voice need to run?

Going by SKILL.md and its folder, The Voice needs the command-line tools its instructions call (npm, npx, pnpm, yarn and bun). Our summary lists: Node.js.

Does The Voice access the network?

SKILL.md names 1 domain. As links in the text: turborepo.dev. This is read from the text; nothing was executed.

Is The Voice safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does The Voice use?

The Voice is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does The Voice use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 984 tokens, read only when the agent opens those files.

What are the alternatives to The Voice?

Skills that share tags, products or a category with The Voice: Monorepo Management (gluestack/gluestack-ui, 5.3k stars), TS SDK Author (mindfold-ai/Trellis, 15k stars), Turborepo Caching (wshobson/agents, 40k stars) and Turborepo (JetBrains/skills, 366 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains The Voice?

yamcodes (a GitHub user) maintains it in yamcodes/arkenv, which has 145 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 9, 2026.

Source: yamcodes/arkenv on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.