Agent skill

Convex Best Practices

by julianromli in julianromli/ai-skills

Guidelines for building production-ready Convex apps covering function organization, query patterns, validation, TypeScript usage, error handling, and the Zen of Convex design philosophy

No licenceAuto-check passedDevelopment

Install Convex Best Practices

skills CLI
$ npx skills add julianromli/ai-skills --skill convex-best-practices -a claude-code

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

GitHub CLI
$ gh skill install julianromli/ai-skills convex-best-practices --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/julianromli/ai-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/convex-best-practices .claude/skills/convex-best-practices && 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
convex-best-practices
GitHub stars
191
Token cost
~2.4k tokens
SKILL.md length
347 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
None found

At a glance

Guidelines for building production-ready Convex apps covering function organization, query patterns, validation, TypeScript usage, error handling, and the Zen of Convex design philosophy

  • Works in 5 steps: Convex manages the hard parts - Let… → Functions are the API - Design your… → Schema is truth - Define your data model… → …
  • Tasks that involve Error handling
  • SKILL.md covers Code Quality, Documentation Sources, Instructions and Examples, plus 3 more sections
  • Calls npm and npx

What it does

Convex Best Practices is an agent skill from julianromli/ai-skills. Guidelines for building production-ready Convex apps covering function organization, query patterns, validation, TypeScript usage, error handling, and the Zen of Convex design philosophy

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

It sits in Development, covering Error handling. It works with TypeScript. The repository describes itself as: Claude Code, Droid, etc. Skills Ability.

When your agent uses it

  • Tasks that involve Error handling

Example prompts

  • “Use the convex-best-practices skill to guideline for building production-ready Convex apps covering function organization, query patterns…”
  • “/convex-best-practices”

Requirements

  • Node.js

Workflow steps

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

  1. Convex manages the hard parts - Let Convex handle caching, real-time sync, and consistency
  2. Functions are the API - Design your functions as your application's interface
  3. Schema is truth - Define your data model explicitly in schema.ts
  4. TypeScript everywhere - Leverage end-to-end type safety
  5. Queries are reactive - Think in terms of subscriptions, not requests

What it can do on your machine

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

    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 Best Practices loads about 2.4k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 347 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 347 words (~2,420 tokens).

“Build production-ready Convex applications by following established patterns for function organization, query optimization, validation, TypeScript usage, and error handling.”

— opening of SKILL.md by julianromli
name
convex-best-practices

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/convex-best-practices of julianromli/ai-skills.

Open the folder on GitHubat commit cf41ea2

Compare with similar skills

Convex Best Practices 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.

Convex Best Practices compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Convex Best Practices this skilljulianromli/ai-skills191—~2.4kAutomated safety check: PassNone
Cross-Language Coding Standardszereight/gitlab-mcp2k1 repos~1.4kAutomated safety check: PassMIT
evlog Map Rule Creatorevloghq/evlog1.9k—~2.9kAutomated safety check: PassMIT
Strict Programming Practicescode-yeongyu/oh-my-openagent70k—~9.5kAutomated safety check: PassCustom licence
Error Causes Handlingparalleldrive/aidd384—~1.1kAutomated safety check: PassMIT
Typescript Rulesshinpr/ai-coding-project-boilerplate234—~1.5kAutomated safety check: PassMIT

Similar skills

  • Shared reference for naming, function size, complexity and error handling rules that reviewer agents apply across TypeScript, Python, Go, Rust, Java, C# and Swift.

    2k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • Walks through adding a new rule or framework adapter to `evlog map` in @evlog/cli, from the rule source and registry to types, tests, docs and the published skill.

    1.9k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Strict Programming Practices

    code-yeongyu/oh-my-openagent

    Applies strict, type-first coding rules for Python, Rust, TypeScript and Go, loading the matching language reference before the agent writes or edits any code.

    70k GitHub stars~9.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Error Causes Handling

    paralleldrive/aidd

    Has your agent throw and catch JavaScript and TypeScript errors with the error-causes library, using named causes, preserved originals and routed handlers.

    384 GitHub stars~1.1k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Typescript Rules

    shinpr/ai-coding-project-boilerplate

    Applies type safety and error handling rules. An agent skill from shinpr/ai-coding-project-boilerplate.

    234 GitHub stars~1.5k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • Error Handling

    affaan-m/ECC

    Patterns for robust error handling across TypeScript, Python, and Go.

    276k GitHub starsUsed in 1 repo~2.7k tokens
    DevelopmentAuto-check passed

More from julianromli/ai-skills

  • Landing Page Copywriter

    julianromli/ai-skills

    Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand.

    191 GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed
  • Hermes Wag Summarizer

    julianromli/ai-skills

    Plug & play skill untuk membuat cronjob summary grup WhatsApp secara otomatis menggunakan Hermes WhatsApp Bridge.

    191 GitHub stars~826 tokensUpdated 4 mo ago
    Auto-check passed
  • Clone Website

    julianromli/ai-skills

    Reverse-engineer and clone one or more websites in one shot — extracts assets, CSS, and content section-by-section and proactively dispatches parallel builder agents in worktrees as it goes.

    191 GitHub starsUsed in 2 repos~7.6k tokens
    Auto-check passed
  • Refactor Clean

    julianromli/ai-skills

    Safely identify and remove dead code with test verification at every step.

    191 GitHub stars~1.3k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Convex Best Practices

What does Convex Best Practices do?

Guidelines for building production-ready Convex apps covering function organization, query patterns, validation, TypeScript usage, error handling, and the Zen of Convex design philosophy. Convex Best Practices is an agent skill from julianromli/ai-skills.

When should I use Convex Best Practices?

Convex Best Practices fits situations like: tasks that involve Error handling.

How do I install Convex Best Practices in Claude Code?

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

How do I install Convex Best Practices in Codex?

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

Can I use Convex Best Practices 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 julianromli/ai-skills --skill convex-best-practices -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-best-practices, .gemini/skills/convex-best-practices, .github/skills/convex-best-practices and .opencode/skills/convex-best-practices in your project.

What does Convex Best Practices need to run?

Going by SKILL.md and its folder, Convex Best Practices needs the command-line tools its instructions call (npm and npx). Our summary lists: Node.js.

Does Convex Best Practices 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 Best Practices 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 Best Practices use?

No licence was found for Convex Best Practices or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Convex Best Practices use?

About 2.4k tokens (SKILL.md is roughly 9.7k 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 Best Practices?

Skills that share tags, products or a category with Convex Best Practices: Cross-Language Coding Standards (zereight/gitlab-mcp, 2k stars), evlog Map Rule Creator (evloghq/evlog, 1.9k stars), Strict Programming Practices (code-yeongyu/oh-my-openagent, 70k stars) and Error Causes Handling (paralleldrive/aidd, 384 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Convex Best Practices?

julianromli (a GitHub user) maintains it in julianromli/ai-skills, which has 191 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on June 9, 2026.

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