Convex Explain App

Point this at an existing Convex project and it maps the whole thing before you touch anything: every table with its fields and the `v.id` foreign-key links between them, the indexes that show the intended access paths, and a clean split of public query/mutation/action functions from internal ones that clients can't reach. It also states how auth and ownership are enforced, including plainly saying when there's no auth foundation at all. Read-only by design, so it describes what the code does and leaves audits to the review skills. The part I'd lean on hardest is the public-versus-internal split, since skimming source is where newcomers most often get that wrong. It's a sensible first step before a refactor or an optimization pass.

skills.sh installs: 41K
GitHub stars: 69
last updated: Oct 26, 2026

View on GitHub

Install

$ npx -y skills add convex/agent-skills --skill convex-explain-app --agent claude-code

Installs into .claude/skills of the current project.

Files

Explain this Convex app

Before you can safely change an app you have to know what it is — and reading 15 function files top-to-bottom is slow and error-prone. This capability produces the map fast and accurately by reading the two sources that can't lie: the schema (the data model) and the function surface (functionSpec / the exported queries/mutations/actions). It is deliberately DESCRIPTIVE — it explains what IS, hands judgment to the audit capabilities and changes to the fixers. It is also the natural first step of an optimize or self-heal session, and the reusable 're-explain the current architecture' that 'change what you built' depends on.