Agent skill

Cad Reference

by Convex-Dev in Convex-Dev/convex

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

Custom licenceAuto-check passed

Install Cad Reference

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

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

GitHub CLI
$ gh skill install Convex-Dev/convex cad-reference --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/cad-reference .claude/skills/cad-reference && 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
cad-reference
GitHub stars
117
Token cost
~165 tokens
SKILL.md length
48 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Custom licence

At a glance

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

  • Find which CAD governs a subsystem before changing protocol
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Economic behaviour

What it does

Cad Reference is an agent skill from Convex-Dev/convex. Index of the Convex Architecture Documents (CADs), the normative specifications for Convex. Use to find which CAD governs a subsystem before changing protocol, encoding, consensus or economic behaviour.

Its SKILL.md is about 170 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

  • Find which CAD governs a subsystem before changing protocol
  • Economic behaviour

Example prompts

  • “/cad-reference”

What it can do on your machine

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

Cad Reference loads about 165 tokens when it runs. Until then it costs about 54 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
~54
When it runs · the whole SKILL.md, loaded when a task matches
~165

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 (~165 tokens).

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

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

Read the full SKILL.md on GitHub

Files

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

Open the folder on GitHubat commit 9e199a3

Compare with similar skills

Cad Reference 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.

Cad Reference compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cad Reference this skillConvex-Dev/convex117—~165Automated safety check: PassCustom licence
Convexdavila7/claude-code-templates32k3 repos~6.4kAutomated safety check: NotesMIT
Indexabilitythedaviddias/Front-End-Checklist74k—~814Automated safety check: PassMIT
Convexopenclaw/clawhub9.5k—~2.4kAutomated safety check: PassMIT
Agent Specificationruvnet/ruflo74k3 repos~1.8kAutomated safety check: PassMIT
Parametric CAD Modelingearthtojake/text-to-cad18k—~2.8kAutomated 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
  • Indexability

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site for accidental noindex directives, investigating why important pages are not appearing in Google Search, or reviewing CMS settings that control indexing…

    74k GitHub stars~814 tokensUpdated yesterday
    Marketing & SEOAuto-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 yesterday
    Backend & APIsAuto-check passed
  • Agent skill for specification - invoke with $agent-specification

    74k GitHub starsUsed in 3 repos~1.8k tokens
    Product & Project ManagementAuto-check passed
  • Parametric CAD Modeling

    earthtojake/text-to-cad

    Creates and edits parametric CAD parts in Python, organizes multi-model projects, exports to STEP, STL, 3MF or GLB, and opens existing CAD files for visual review.

    18k GitHub stars~2.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Indexability Conflicts

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site for indexability issues, investigating why pages appear in Google's index that should be excluded (or vice versa), or reviewing robots.txt and meta…

    74k GitHub stars~876 tokensUpdated yesterday
    Marketing & SEOAuto-check passed

More from Convex-Dev/convex

All 12 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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    Auto-check passed
  • Convex Lisp

    Convex-Dev/convex

    Convex Lisp language reference — CVM conventions, calling library code, actor definitions, juice and error codes.

    117 GitHub stars~161 tokensUpdated yesterday
    Auto-check passed

Questions about Cad Reference

What does Cad Reference do?

Index of the Convex Architecture Documents (CADs), the normative specifications for Convex. Cad Reference is an agent skill from Convex-Dev/convex. Index of the Convex Architecture Documents (CADs), the normative specifications for Convex.

When should I use Cad Reference?

Cad Reference fits situations like: find which CAD governs a subsystem before changing protocol; economic behaviour.

How do I install Cad Reference in Claude Code?

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

How do I install Cad Reference in Codex?

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

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

What does Cad Reference need to run?

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

Does Cad Reference 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 Cad Reference 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 Cad Reference use?

Cad Reference 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 Cad Reference use?

About 165 tokens (SKILL.md is roughly 660 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 Cad Reference?

Skills that share tags, products or a category with Cad Reference: Convex (davila7/claude-code-templates, 32k stars), Indexability (thedaviddias/Front-End-Checklist, 74k stars), Convex (openclaw/clawhub, 9.5k stars) and Agent Specification (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cad Reference?

Convex-Dev (a GitHub organization) maintains it in Convex-Dev/convex, which has 117 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 6, 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.