get-convex / agent-skills
★ 35A skill package that teaches your agent 6 capabilities — every one documented and browsable below, no GitHub required · by get-convex.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
Routes general Convex requests to the right project skill. Use when the user asks which Convex skill to use or gives an underspecified Convex app task.
1 file — installable on its own
Builds reusable Convex components with isolated tables and app-facing APIs. Use for new components, reusable backend modules, integrations, or component boundary work.
10 files — installable on its own
Plans Convex schema and data migrations with widen-migrate-narrow and @convex-dev/migrations. Use for breaking schema changes, backfills, table reshaping, or zero-downtime rollouts.
8 files — installable on its own
Audits Convex performance for reads, subscriptions, write contention, and function limits. Use for slow features, insights findings, OCC conflicts, or read amplification.
10 files — installable on its own
Creates or adds Convex to an app. Use for new Convex projects, npm create convex@latest, frontend setup, env vars, or the first npx convex dev run.
5 files — installable on its own
Sets up Convex auth, identity mapping, and access control. Use for login, auth providers, users tables, protected functions, or roles in a Convex app.
10 files — installable on its own
Convex Agent Skills
Agent skills for common Convex workflows.
Install
# Choose which skills you want
npx skills add get-convex/agent-skills
# OR Install all skills
npx skills add get-convex/agent-skills --allUsage
Skills are applied automatically when the agent determines they're relevant. How you manually invoke them depends on your tool:
| Tool | Manual invocation |
|---|---|
| Cursor | /skill-name |
| VS Code (GitHub Copilot) | /skill-name |
| Claude Code | /skill-name |
| Windsurf | @skill-name |
| Codex (OpenAI) | $skill-name |
For example, to kick off auth setup in Cursor or Claude Code:
/convex-setup-authIn Windsurf:
@convex-setup-authAvailable Skills
convex- Top-level entry point for Convex work. Recommends installing Convex AI files, then routes to a more specific Convex skill.convex-quickstart- Start a new Convex project or add Convex to an existing app.convex-setup-auth- Set up authentication for a Convex app.convex-create-component- Build a reusable Convex component with clear boundaries.convex-migration-helper- Plan and run Convex migrations safely.convex-performance-audit- Investigate Convex performance problems and bottlenecks.
Skill Philosophy
Skills in this repo should be laser-focused on a specific task or workflow.
A good skill helps an agent take action, for example:
- set up authentication
- create a component
- perform a migration
- diagnose performance issues
A skill should not exist just to provide generic background information. If content is mostly reference material, it should usually live in documentation, not as a standalone skill.
Reference material is still useful inside a skill, but only when it helps the agent complete a concrete task.
Contributing
Before contributing, review the core Agent Skills docs:
- Overview
- What are skills?
- Specification
- Optimizing skill descriptions
- Evaluating skill output quality
If your skill bundles scripts, also read Using scripts in skills.
Install dependencies once with npm install, then use:
npm run formatto rewrite filesnpm run format-checkto verify formatting before opening a PR
Validating Skills
Validate skills by trying to use them in a realistic temp project, not just by reading them.
- Push the skill as far as possible with an agent in a throwaway directory
- If a human must intervene, ask explicitly for the exact action needed and then continue
- Record what worked, where the agent got stuck, and what confused the flow
- Feed those learnings back into the skill so the next run is better
- For UI-facing skills such as auth setup, validate the actual browser flow during skill development, not just code generation or a successful build
Testing with Anthropic's Skill Creator
For a more rigorous approach, use Anthropic's skill-creator skill. It provides a structured loop for testing and iterating on skills:
- Draft or edit a skill
- Define realistic test prompts and run the skill against them (with and without the skill as a baseline)
- Grade the outputs with assertions and review them in a browser-based viewer
- Improve the skill based on feedback, then repeat
It also includes a description optimizer that tunes the skill's frontmatter description for better triggering accuracy across different phrasings.
Install it in Claude Code:
/install-skill https://github.com/anthropics/skills/tree/main/skills/skill-creatorThis is especially useful when a skill is complex enough that reading it alone won't tell you if it actually works well in practice.
Each skill follows the Agent Skills open standard:
- Create a directory under
skills/with the skill name - Add a
SKILL.mdfile with YAML frontmatter:Copy & paste — that's it--- name: skill-name description: Brief description --- - Include comprehensive examples with bad/good patterns
- Add a checklist at the end of each skill
- Update this root
README.mdwhenever skills are added, removed, renamed, or substantially repositioned
Install the whole package (6 skills):
npx skills add https://github.com/get-convex/agent-skillsOr install a single skill:
npx skills add https://github.com/get-convex/agent-skills --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.