abrahamvilchesdelacruz/ididntcatchthat/api-criteria
Claude Code and agent skill by abrahamvilchesdelacruz/ididntcatchthat
- community
Checking that the SKILL.md file is still in the repository.
Convenciones del patrón Criteria en la API: construcción desde query params, uso en use cases y repositorios. Trigger: Al construir queries con filtros, orden o paginación en apps/api/.
Install
npx vskill@latest install abrahamvilchesdelacruz/ididntcatchthat/api-criteriaSKILL.md
The same SKILL.md was published earlier as abrahamvilchesdelacruz/ididntcatchthat/api-criteria.
When to Use
- Al implementar un endpoint con filtros, orden o paginación
- Al pasar criterios de búsqueda desde controller a use case a repositorio
- Al implementar
match(criteria)en un repositorio TypeORM
Leereferences/docs.mdpara skills relacionadas, ADRs y documentación externa.
Leereferences/repository-criteria.mdpara la implementación completa delmatch(), el flujo Controller → UseCase → Repository y la tabla de operadores.
Estructura de Criteria
Criteria vive en shared/domain/ — es transversal a todos los bounded contexts:
Construcción — siempre new Criteria([...])
Filtros opcionales — construcción condicional
Cuando no todos los filtros son obligatorios, construir el array dinámicamente:
Paginación con page/pageSize y count()
El cliente envía page + pageSize (más natural que offset). El use case convierte y ejecuta match y count en paralelo:
El repositorio debe exponer count(criteria: Criteria): Promise<number> junto a match().
Reglas
Criterialo construyen el use case o domain services — nunca el controller ni el repositorio- El controller pasa primitivos como parte del
Request*— nunca pasa un objetoCriteria - El repositorio solo consume
Criteria— nunca recibe filtros sueltos por parámetro value: nullconEQ/NEQ→IS NULL/IS NOT NULL(nunca= nullen SQL)- Usar
OrderDirectionenum — no strings literales'ASC'/'DESC' - No existe
Criteria.fromPrimitives()— usar el constructor directamente
Anti-patterns
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/api-criteria/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/abrahamvilchesdelacruz/ididntcatchthat/api-criteria)