| name | api-rest |
| description | Generate Bruno API test collections from project API definitions. Use when creating API tests, exporting collections, or testing REST endpoints. |
API-to-Bruno Collection Generator Skill
Descripción
Analiza API completa de proyecto y genera colección Bruno con subdirs por modelo de negocio, requests .bru separados, assertions, tests JS/Chai, docs. Ejecutable en Bruno app.
Inputs Requeridos
- Código fuente proyecto (repositorio/archivos API: routes, controllers, schemas)
- Base URL del proyecto
- Esquemas/auth details (opcional)
Outputs
- Carpeta colección Bruno: collection.bru, subdirs/.bru, requests/.bru, environments/*.bru
- Archivos listos para Git/Bruno CLI:
bru run --env dev
Dependencias
- Bruno >= v1.20 [web:42]
- Chai assertions en tests [web:23]
- bru.setVar() para variables cross-request
Ejecución
- Analizar código → mapear endpoints
- Inferir modelo negocio → crear subdirs
- Generar .bru por request: http{}, assertions{}, tests{}, docs{}
- Validar sintaxis Bruno YAML/Bru
- Test local: abrir Bruno → load collection → run all → 100% pass
Best Practices Integradas [web:16][web:39][web:40]
- Vars env: {{base_url}}, {{auth_token}}
- Tests: status, body keys/types, nested objects, arrays/loops, headers, response time
- Assertions: res.getStatus() eq 200, res.getBody() has.property('id')
- Docs: params, expected response, errors
Ejemplo Output Structure
api-tests/
├── collection.bru
├── auth/
│ ├── login.bru
│ └── refresh.bru
├── users/
│ ├── GET-users.bru
│ └── POST-user.bru
└── environments/
└── dev.bru
