# Convex Explain App

> Explain an existing Convex app — data model + relationships, public vs internal functions, auth/ownership model, components, a request→data flow — read from the schema and function surface. Read-only.

Source: https://skillsagentes.com/skills/get-convex/agent-skills/convex-explain-app
Repository: https://github.com/get-convex/agent-skills
Author: get-convex
License: not specified
Updated: hace 13 días
Context cost: 52 tok installed, 1k tok once triggered, 1k tok with every bundled file
Bundle: 1 file, 4 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add get-convex/agent-skills --skill convex-explain-app --agent claude-code
```

## What it does

- Lee schema.ts y el function surface (functionSpec) para mapear tablas y relaciones
- Separa funciones públicas (query/mutation/action) de internas (internalQuery/...)
- Describe el modelo de auth/ownership y si no existe fundamento de auth
- Lista componentes @convex-dev/*, rutas HTTP, crons y llamadas externas
- Traza 1-2 flujos end-to-end representativos de petición→datos

## Use it when

- Antes de cambiar una app Convex y necesitas entender qué es primero
- Como primer paso natural de una sesión de optimize o self-heal
- Para re-explicar la arquitectura actual antes de modificarla

## Don't bother when

- Cuando lo que se necesita es auditar el código en busca de fallos (usa convex-reviewer/convex-authz)
- Cuando se necesita puntuar el launch-readiness o extender la app (usa design/convex-expert)

## What triggers it

- "Explícame cómo está construida esta app de Convex"
- "Mapea el modelo de datos y las funciones públicas vs internas de este proyecto Convex"
- "¿Cómo funciona el modelo de auth y ownership en esta app?"

## Before you install

- Requiere un directorio convex/ con schema.ts, y opcionalmente un deployment (usando el MCP oficial para functionSpec/tables en modo solo lectura).

## Files

- SKILL.md — 4 KB

## SKILL.md

Not reproduced here. Read it at https://github.com/get-convex/agent-skills/blob/main/skills/convex-explain-app/SKILL.md

---

Skills Agentes — https://skillsagentes.com/skills/get-convex/agent-skills/convex-explain-app