Agent skill

Etch

by Convex-Dev in Convex-Dev/convex

Inspect and maintain an Etch store — Convex's content-addressed database.

Custom licenceAuto-check passed

Install Etch

skills CLI
$ npx skills add Convex-Dev/convex --skill etch -a claude-code

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

GitHub CLI
$ gh skill install Convex-Dev/convex etch --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/Convex-Dev/convex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/etch .claude/skills/etch && 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
etch
GitHub stars
117
Token cost
~151 tokens
SKILL.md length
48 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Custom licence

At a glance

Inspect and maintain an Etch store — Convex's content-addressed database.

  • Examining peer storage
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Diagnosing corruption
  • Garbage collecting

What it does

Etch is an agent skill from Convex-Dev/convex. Inspect and maintain an Etch store — Convex's content-addressed database. Use when examining peer storage, diagnosing corruption, garbage collecting, or reading data by hash.

Its SKILL.md is about 150 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Convex Main Repository - Decentralised platform for the Internet of Value.

When your agent uses it

  • Examining peer storage
  • Diagnosing corruption
  • Garbage collecting
  • Reading data by hash

Example prompts

  • “/etch”

What it can do on your machine

Read from SKILL.md and the folder at commit 0fec9b9. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Etch loads about 151 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 48 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~151

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 48 words (~151 tokens).

“This is the Codex discovery entry for the canonical shared skill at .claude/skills/etch/SKILL.md.”

— opening of SKILL.md by Convex-Dev, Custom licence
name
etch

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/etch of Convex-Dev/convex.

Open the folder on GitHubat commit 0fec9b9

Compare with similar skills

Etch 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.

Etch compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Etch this skillConvex-Dev/convex117—~151Automated safety check: PassCustom licence
Convexdavila7/claude-code-templates32k3 repos~6.4kAutomated safety check: NotesMIT
Agent App Storeruvnet/ruflo74k3 repos~1kAutomated safety check: PassMIT
Wiki Maintaineropenclaw/openclaw392k1 repos~462Automated safety check: PassMIT
Convexopenclaw/clawhub9.5k—~2.4kAutomated safety check: PassMIT
Node Inspect Debuggeropenclaw/openclaw392k1 repos~894Automated safety check: PassMIT

Similar skills

  • Convex

    davila7/claude-code-templates

    Convex reactive backend expert: schema design, TypeScript functions, real-time subscriptions, auth, file storage, scheduling, and deployment.

    32k GitHub starsUsed in 3 repos~6.4k tokens
    DatabasesAuto-check: notes
  • Agent App Store

    ruvnet/ruflo

    Agent skill for app-store - invoke with $agent-app-store. An agent skill from ruvnet/ruflo.

    74k GitHub starsUsed in 3 repos~1k tokens
    MobileAuto-check passed
  • Wiki Maintainer

    openclaw/openclaw

    Maintain the OpenClaw memory wiki vault with deterministic pages, managed blocks, and source-backed updates.

    392k GitHub starsUsed in 1 repo~462 tokens
    Knowledge ManagementAuto-check passed
  • Convex

    openclaw/clawhub

    Convex is the backend agents get right on the first try: an all-TypeScript reactive platform where the database, server functions, scheduling, file storage, auth, and realtime sync are one type-safe…

    9.5k GitHub stars~2.4k tokensUpdated today
    Backend & APIsAuto-check passed
  • Node Inspect Debugger

    openclaw/openclaw

    Debug Node.js with node inspect, --inspect, breakpoints, CDP, heap, and CPU profiles.

    392k GitHub starsUsed in 1 repo~894 tokens
    Frontend & DesignAuto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed

More from Convex-Dev/convex

All 11 skills in this repo
  • Account

    Convex-Dev/convex

    Create or inspect Convex accounts. An agent skill from Convex-Dev/convex.

    117 GitHub stars~140 tokensUpdated today
    Auto-check passed
  • Build Convex

    Convex-Dev/convex

    Build the Convex project from source. An agent skill from Convex-Dev/convex.

    117 GitHub stars~139 tokensUpdated today
    Auto-check passed
  • Cad Reference

    Convex-Dev/convex

    Index of the Convex Architecture Documents (CADs), the normative specifications for Convex.

    117 GitHub stars~165 tokensUpdated today
    Auto-check passed
  • Cad3 Encoding

    Convex-Dev/convex

    CAD3 encoding format — cells, embedded vs branch references, value IDs, validity rules.

    117 GitHub stars~164 tokensUpdated today
    Auto-check passed
  • Cns

    Convex-Dev/convex

    Resolve or register Convex Name System (CNS) names. An agent skill from Convex-Dev/convex.

    117 GitHub stars~143 tokensUpdated today
    Auto-check passed
  • Convex DB

    Convex-Dev/convex

    Use Convex DB — a lattice-backed SQL database. An agent skill from Convex-Dev/convex.

    117 GitHub stars~159 tokensUpdated today
    Auto-check passed

Questions about Etch

What does Etch do?

Inspect and maintain an Etch store — Convex's content-addressed database. Etch is an agent skill from Convex-Dev/convex. Inspect and maintain an Etch store — Convex's content-addressed database.

When should I use Etch?

Etch fits situations like: examining peer storage; diagnosing corruption; garbage collecting; reading data by hash.

How do I install Etch in Claude Code?

Run `npx skills add Convex-Dev/convex --skill etch -a claude-code`. Or copy the skill folder (.agents/skills/etch in Convex-Dev/convex) into .claude/skills/etch in your project. Claude Code loads it when a task matches its description.

How do I install Etch in Codex?

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

Can I use Etch 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 Convex-Dev/convex --skill etch -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/etch, .gemini/skills/etch, .github/skills/etch and .opencode/skills/etch in your project.

What does Etch need to run?

SKILL.md names no scripts, command-line tools or credentials: Etch is instructions for the agent only.

Does Etch access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Etch 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 Etch use?

Etch has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Etch use?

About 151 tokens (SKILL.md is roughly 604 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Etch?

Skills that share tags, products or a category with Etch: Convex (davila7/claude-code-templates, 32k stars), Agent App Store (ruvnet/ruflo, 74k stars), Wiki Maintainer (openclaw/openclaw, 392k stars) and Convex (openclaw/clawhub, 9.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Etch?

Convex-Dev (a GitHub organization) maintains it in Convex-Dev/convex, which has 117 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 7, 2026.

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