SWSkillsWay.ai
View Repo ↗
Skillset · / get-convex / agent-skills

get-convexget-convex/agent-skills

PurposeA collection of focused Agent Skills for common Convex workflows (quickstart, auth, components, migrations, performance). Skills auto-apply when an agent detects relevance, or can be manually invoked per tool syntax. Designed as small, task-driven modules following the Agent Skills open standard, they help AI agents take concrete actions rather than serve as reference docs. Ideal for devs using Cursor, VS Code, Claude Code, Windsurf, or Codex to build and maintain Convex apps efficiently.
Skill Count
6
Required CLI
convex
Domains
Coding
Forms
Workflow
Skillset Analysis

Core Idea

Principles & Methodology

The author's design philosophy, what sets this apart from peer projects, and quick notes on the key workflows. Skill names mentioned in the text auto-link to their detail pages.

Core Philosophy

Unlike generic doc repos, Convex Agent Skills follow a strict "action-over-reference" principle:

  • Laser-focused: Each skill targets one concrete workflow (auth, component, migration, perf).
  • Task-driven: Skills must help the agent take action, not just provide background info.
  • Auto-routed: The convex skill is the entry point that recommends AI files then routes to specific skills.

Workflow

Skills are auto-loaded by the agent when relevant, or manually invoked via /convex-setup-auth etc. Typical flow: use convex or convex-quickstart to init, then call focused skills like convex-setup-auth, convex-create-component, convex-migration-helper, convex-performance-audit as needed.

Best Practice

Validate skills in throwaway projects; use Anthropic skill-creator for rigorous testing.

SkillsWay.ai · Heads-Up Agent Skills InspectorUnderstand Agent Skills before you install.

Skill Relationships

Usage Relationships Between Skills

Skill → Skill usage relationships, with cross-layer references. Same color blocks indicate the same skill form.

Relationship Count
8
Standalone Skills
0
Most Referencing
  • convex5 downstream skills
  • convex-performance-audit1 downstream skills
Most Referenced
  • convex-migration-helper2 upstream skills
  • convex-setup-auth2 upstream skills

Note: Each dependency line reads as "the current Skill depends on" the Skill it points to.

Skill Composition

How skills in this set are triggered

Each skill is designed for a specific kind of caller — some only fire when you name them, others load automatically when the model judges them relevant. The split below summarises both modes at a glance.

User-Invoked1

These skills only fire when you call them by name. The agent will not load them on its own — they stay inert until invoked.

convex-setup-auth
Model-Invoked6

These skills are loaded automatically by the agent when it judges the context relevant. You usually don't need to call them yourself.

convexconvex-create-componentconvex-migration-helperconvex-performance-auditconvex-quickstartconvex-setup-auth

Skill List

6 Skills · Filter by name or domain

convex

A routing skill for Convex work in a repo. It recommends installing official Convex AI files via `npx convex ai-files install` and directs users to specific Convex skills like quickstart or auth. Value: ensures correct setup and efficient task routing.

→
Domain
Coding
Form
Workflow
Location
skills/convex/SKILL.md

convex-create-component

Guides creation of reusable Convex components with clear boundaries and minimal app-facing API. Uses decision tree to pick local/packaged/hybrid shape, scaffolds schema/functions, wires via app.use, and validates with npx convex dev. Value: isolated tables, reusable backend logic, safe auth/env handling.

→
Domain
Coding
Form
Workflow
Location
skills/convex-create-component/SKILL.md

convex-migration-helper

Helps safely migrate Convex schemas and data during breaking changes. Uses a widen-migrate-narrow deploy workflow and the @convex-dev/migrations component for batched online migrations. Produces verified, zero-downtime migration plans with code patterns and checklists, avoiding deploy rejections and data loss.

→
Domain
Coding
Form
Workflow
Location
skills/convex-migration-helper/SKILL.md

convex-performance-audit

Diagnose and fix Convex app performance issues one problem class at a time. Uses insights CLI and code tracing to find read amplification, OCC conflicts, subscription cost, and budget limits. Delivers verified cross-function fixes that reduce cost and latency.

→
Domain
Coding
Form
Workflow
Location
skills/convex-performance-audit/SKILL.md

convex-quickstart

Quickly sets up a working Convex project by scaffolding new apps or adding Convex to existing ones. Uses `npm create convex@latest` and `npx convex dev --once` to provision deployments, push code, and typecheck. Produces a configured backend with generated types and a running dev loop for fast prototyping.

→
Domain
Coding
Form
Workflow
Location
skills/convex-quickstart/SKILL.md

convex-setup-auth

Helps implement secure authentication in Convex with user management and access control. Guides provider selection, reads official docs and local references, follows a stepwise workflow to wire clients and protect backend functions. Delivers verified, production-ready or local Convex auth setup with correct patterns.

→
Domain
Coding
Form
Workflow
Location
skills/convex-setup-auth/SKILL.md

Showing 6 / 6

Installation

One command to install the entire Skillset.

Copy and run in your terminal to add get-convex/agent-skills to your Agent environment.

$npx skills add get-convex/agent-skills