npx skills add get-convex/agent-skillsApache-2.062 stars15,033 wordsUpdated 9 September 2026
33 skills · 70 min
| Week | Installs |
|---|---|
| Week 1 | 18,652 |
| Week 2 | 11,818 |
| Week 3 | 10,245 |
| Week 4 | 9,665 |
| Week 5 | 11,103 |
| Week 6 | 10,698 |
| Week 7 | 9,887 |
| Week 8 | 8,064 |
Agent skills for common Convex workflows.
Unless otherwise noted, all original content in this repository is licensed under the Apache License 2.0 (opens in a new tab). This includes the skill instructions, reference documentation, and source code in revisions that include this license. It does not retroactively change the licensing of earlier revisions.
Third-party materials remain under their respective licenses. See THIRD_PARTY_NOTICES.md (opens in a new tab) for details.
# Choose which skills you want
npx skills add get-convex/agent-skills
# OR Install all skills
npx skills add get-convex/agent-skills --allSkills 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-authconvex - 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.Skills in this repo should be laser-focused on a specific task or workflow.
A good skill helps an agent take action, for example:
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.
Before contributing, review the core Agent Skills docs:
If your skill bundles scripts, also read Using scripts in skills (opens in a new tab).
Install dependencies once with pnpm install, then use:
pnpm format to rewrite filespnpm format-check to verify formatting before opening a PRValidate skills by trying to use them in a realistic temp project, not just by reading them.
For a more rigorous approach, use Anthropic’s skill-creator (opens in a new tab) skill. It provides a structured loop for testing and iterating on skills:
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 (opens in a new tab):
skills/ with the skill nameSKILL.md file with YAML frontmatter:
---
name: skill-name
description: Brief description
---README.md whenever skills are added, removed, renamed, or
substantially repositionedmain, last pushed 9 September 2026.SKILL.md, not by matching a directory convention. One layout observed: skills/*/SKILL.md.h1 and no skipped levels:/get-convex/agent-skills.md, and each skill at its own .md URL.