Atomicmail
Atomic-Mail/atomic-mail-agentic
Read and write email through the Atomic Mail from an AI agent.
Routes Convex work to the right builder skill and covers the handful of rules that apply everywhere: validators on every function, withIndex over filter, idempotent mutations, internal functions for…
Install Convex
$ npx skills add waynesutton/builder-skills --skill convex -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install waynesutton/builder-skills convex --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/waynesutton/builder-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/convex .claude/skills/convex && rm -rf skills-srcUse ~/.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/
Install the "convex" agent skill from https://github.com/waynesutton/builder-skills/tree/main/skills/convex into .claude/skills/convex/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "convex", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/waynesutton/builder-skills/tree/main/skills/convexType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add waynesutton/builder-skills --skill convex -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install waynesutton/builder-skills convex --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/waynesutton/builder-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/convex .agents/skills/convex && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "convex" agent skill from https://github.com/waynesutton/builder-skills/tree/main/skills/convex into .agents/skills/convex/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "convex", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add waynesutton/builder-skills --skill convex -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install waynesutton/builder-skills convex --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/waynesutton/builder-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/convex .cursor/skills/convex && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "convex" agent skill from https://github.com/waynesutton/builder-skills/tree/main/skills/convex into .cursor/skills/convex/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "convex", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/waynesutton/builder-skills.git --path skills/convex--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add waynesutton/builder-skills --skill convex -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install waynesutton/builder-skills convex --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/waynesutton/builder-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/convex .gemini/skills/convex && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "convex" agent skill from https://github.com/waynesutton/builder-skills/tree/main/skills/convex into .gemini/skills/convex/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "convex", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install waynesutton/builder-skills convexInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add waynesutton/builder-skills --skill convex -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/waynesutton/builder-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/convex .github/skills/convex && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "convex" agent skill from https://github.com/waynesutton/builder-skills/tree/main/skills/convex into .github/skills/convex/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "convex", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add waynesutton/builder-skills --skill convex -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install waynesutton/builder-skills convex --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/waynesutton/builder-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/convex .opencode/skills/convex && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "convex" agent skill from https://github.com/waynesutton/builder-skills/tree/main/skills/convex into .opencode/skills/convex/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "convex", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
convex- GitHub stars
- 404
- Token cost
- ~768 tokens
- SKILL.md length
- 321 words
- Files
- 4 (incl. assets)
- Skills in repo
- 17
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Routes Convex work to the right builder skill and covers the handful of rules that apply everywhere: validators on every function, withIndex over filter, idempotent mutations, internal functions for…
- A task mentions Convex and no more specific skill matches
- SKILL.md covers Pick a skill, Rules that hold everywhere, Do not and Docs
- Calls npx
- As the first stop before picking one
What it does
Convex is an agent skill from waynesutton/builder-skills. Routes Convex work to the right builder skill and covers the handful of rules that apply everywhere: validators on every function, withIndex over filter, idempotent mutations, internal functions for scheduling. Use when a task mentions Convex and no more specific skill matches, or as the first stop before picking one.
Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including assets (for example `agents/openai.yaml`).
It sits in Productivity & Automation. The repository describes itself as: Builder skills for Convex apps. Convex patterns plus a PRD, task.md, changelog, and files.md workflow for Claude Code, Codex, Cursor, and OpenCode. The licence is Apache-2.0.
When your agent uses it
- A task mentions Convex and no more specific skill matches
- As the first stop before picking one
Example prompts
- “Use the convex skill to route Convex work to the right builder skill and covers the handful of rules that apply everywhere: validators on every…”
- “/convex”
Requirements
- Node.js
What it can do on your machine
Read from SKILL.md and the folder at commit 82d1ce2. 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:
npx
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):
docs.convex.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
Convex loads about 768 tokens when it runs. Until then it costs about 82 tokens; SKILL.md has 321 words of instructions outside code blocks.
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 waynesutton/builder-skills at commit 82d1ce2, republished under its Apache-2.0 licence (© waynesutton). 321 words, ~768 tokens.
Download SKILL.mdSave it as
.claude/skills/convex/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.- name
- convex
- description
- Routes Convex work to the right builder skill and covers the handful of rules that apply everywhere: validators on every function, withIndex over filter, idempotent mutations, internal functions for scheduling. Use when a task mentions Convex and no more specific skill matches, or as the first stop before picking one.
Convex
Start here, pick the matching skill below, and load it. If nothing matches, the rules at the bottom still apply.
Pick a skill
| Skill | Load when |
|---|---|
| convex-best-practices | general patterns, project structure, "is this the Convex way" |
| convex-functions | queries, mutations, actions, internal functions, error handling |
| convex-schema-validator | tables, indexes, validators, v.* types, schema changes |
| convex-realtime | useQuery, optimistic updates, pagination, presence, rerender churn |
| convex-http-actions | webhooks, REST endpoints, convex/http.ts, Stripe or Clerk callbacks |
| convex-file-storage | uploads, upload URLs, serving files, storage cleanup |
| convex-cron-jobs | crons.ts, runAfter, runAt, batching, a cron that is not firing |
| convex-migrations | backfills, renaming fields, schema evolution with live data |
| convex-agents | AI agents, threads, tools, streaming, RAG with @convex-dev/agent |
| convex-component-authoring | building a reusable component package, defineComponent |
| convex-security-check | fast pre ship audit: auth on public functions, exposed data |
| convex-security-audit | deep review: authorization model, injection, rate limits, secrets |
| avoid-feature-creep | scope pushback, MVP cuts, "just one more feature" |
| project-workflow | multi step tasks, PRDs in prds/, task.md, plans for review |
| project-docs | syncing task.md, changelog.md, files.md with shipped code |
| git-safety | revert, undo, reset, checkout, clean, stash, force push |
Two skills often apply at once. Load the domain skill for the code and the process skill for the workflow, for example convex-functions plus project-workflow.
Rules that hold everywhere
- Every function declares
argsandreturnsvalidators, including internal ones. - Read through
withIndex..filter()on a table scan is a bug waiting for data. - Mutations are idempotent. Check current state, return early when there is nothing to do.
- Schedule and cron only
internal.*functions. Neverapi.*. - Never call
Date.now()inside a query. Pass time in as an argument. - Use
npx convex devfor development. Do not runnpx convex deployunless asked. - Fetch https://docs.convex.dev/llms.txt before trusting memory about an API.
Do not
- Edit anything under
convex/_generated/. - Use
crons.daily,crons.hourly, orcrons.weekly. Usecrons.intervalorcrons.cron. - Put
"use node"in a file that also exports queries or mutations. - Run git commands that discard work without loading git-safety first.
Docs
© waynesutton, Apache-2.0. 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 3 other files (assets) in skills/convex of waynesutton/builder-skills.
- SKILL.md
- agents/openai.yaml
- assets/large-logo.png
- assets/small-logo.svg
Open the folder on GitHubat commit 82d1ce2
Compare with similar skills
Convex 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Convex this skillwaynesutton/builder-skills | 404 | — | ~768 | Automated safety check: Pass | Apache-2.0 | |
| AtomicmailAtomic-Mail/atomic-mail-agentic | 266 | 1 repos | ~2k | Automated safety check: Pass | MIT | |
| Newsblur CLIsamuelclay/NewsBlur | 7.6k | — | ~1.3k | Automated safety check: Pass | MIT | |
| X Bookmarkssharbelxyz/x-bookmarks | 289 | — | ~2k | Automated safety check: Notes | None | |
| Gmail Emailopen-gitagent/gitagent | 710 | — | ~235 | Automated safety check: Notes | MIT | |
| Zeleremorses/zele | 299 | — | ~1.5k | Automated safety check: Pass | None |
Similar skills
Newsblur CLI
samuelclay/NewsBlur
Manage your NewsBlur from the terminal. An agent skill from samuelclay/NewsBlur.
X Bookmarks
sharbelxyz/x-bookmarks
Fetch, summarize, and manage X/Twitter bookmarks via bird CLI or X API v2.
Gmail Email
open-gitagent/gitagent
Send emails via Gmail SMTP using App Password authentication.
Zele
remorses/zele
zele is a multi-account email and calendar CLI for Gmail, IMAP/SMTP (Fastmail, Outlook, any provider), and Google Calendar.
Google Workspace
yc-software/qm
Read and act on the user's Gmail, Google Calendar, and Google Tasks through per-user OAuth.
More from waynesutton/builder-skills
All 17 skills in this repoConvex Agents
waynesutton/builder-skills
Builds AI agents on the Convex agent component: threads, messages, tools that call queries and mutations, streaming, RAG with vector search, and workflows for multi step jobs.
Convex Best Practices
waynesutton/builder-skills
Production patterns for Convex apps and the rules the @convex-dev/eslint-plugin enforces: validators, indexes, idempotent mutations, avoiding OCC conflicts, thin function wrappers, error handling.
Convex Component Authoring
waynesutton/builder-skills
Creates reusable Convex components with defineComponent, a clean client wrapper, their own schema, and an npm publish setup.
Convex Cron Jobs
waynesutton/builder-skills
Schedules work in Convex: cron jobs in convex/crons.ts, one off scheduled functions with runAfter and runAt, batching large jobs, and cancelling or inspecting the queue.
Convex HTTP Actions
waynesutton/builder-skills
Adds HTTP endpoints in convex/http.ts: webhook receivers with signature checks, REST style routes, CORS, auth headers, streaming responses, and file uploads over HTTP.
Convex Migrations
waynesutton/builder-skills
Changes a live Convex schema without downtime: make a field optional, backfill in batches, flip the validator, then clean up.
Related
Categories
Questions about Convex
What does Convex do?
Routes Convex work to the right builder skill and covers the handful of rules that apply everywhere: validators on every function, withIndex over filter, idempotent mutations, internal functions for…. Convex is an agent skill from waynesutton/builder-skills. Routes Convex work to the right builder skill and covers the handful of rules that apply everywhere: validators on every function, withIndex over filter, idempotent mutations, internal functions for scheduling.
When should I use Convex?
Convex fits situations like: A task mentions Convex and no more specific skill matches; as the first stop before picking one.
How do I install Convex in Claude Code?
Run `npx skills add waynesutton/builder-skills --skill convex -a claude-code`. Or copy the skill folder (skills/convex in waynesutton/builder-skills) into .claude/skills/convex in your project. Claude Code loads it when a task matches its description.
How do I install Convex in Codex?
Run `npx skills add waynesutton/builder-skills --skill convex -a codex`. Or copy the skill folder (skills/convex in waynesutton/builder-skills) into .agents/skills/convex in your project. Codex loads it when a task matches its description.
Can I use Convex 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 waynesutton/builder-skills --skill convex -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/convex, .gemini/skills/convex, .github/skills/convex and .opencode/skills/convex in your project.
What does Convex need to run?
Going by SKILL.md and its folder, Convex needs the command-line tools its instructions call (npx). Our summary lists: Node.js.
Does Convex access the network?
SKILL.md names 1 domain. As links in the text: docs.convex.dev. This is read from the text; nothing was executed.
Is Convex 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 Convex use?
Convex is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Convex use?
About 768 tokens (SKILL.md is roughly 3.1k 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 Convex?
Skills that share tags, products or a category with Convex: Atomicmail (Atomic-Mail/atomic-mail-agentic, 266 stars), Newsblur CLI (samuelclay/NewsBlur, 7.6k stars), X Bookmarks (sharbelxyz/x-bookmarks, 289 stars) and Gmail Email (open-gitagent/gitagent, 710 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Convex?
waynesutton (a GitHub user) maintains it in waynesutton/builder-skills, which has 404 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on September 28, 2026.
Source: waynesutton/builder-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.