@hoilab/ada-cli 0.85.1 → 0.85.3

package/dist/skills/skill-creator/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: skill-creator
+description: Use when the user asks to create, write or package a new Ada skill. Covers the SKILL.md layout, the frontmatter limits Ada's loader actually enforces, where to place the file so it is discovered, and the two Ada-specific rules a skill must never break.
+---
+
+# Crear una skill de Ada
+
+Una skill es un fichero `SKILL.md` con frontmatter YAML. Ada las carga bajo
+demanda: el modelo ve el `name` y la `description` siempre, y el cuerpo solo
+cuando la invoca.
+
+## Límites que el loader impone de verdad
+
+Estos números salen de `src/core/skills.ts`, no de la especificación genérica.
+Pasarse hace que la skill se rechace con un diagnóstico que el usuario
+normalmente no ve:
+
+| Campo | Límite | Regla |
+|---|---|---|
+| `name` | 64 caracteres | **Debe coincidir con el nombre del directorio.** `skills/mi-skill/SKILL.md` → `name: mi-skill` |
+| `description` | 1024 caracteres | Es lo único que el modelo lee para decidir si la invoca |
+
+## Dónde ponerla
+
+| Ruta | Alcance |
+|---|---|
+| `.ada/agent/skills/<nombre>/SKILL.md` | Solo este proyecto (gana sobre la global) |
+| `~/.ada/agent/skills/<nombre>/SKILL.md` | Todos los proyectos |
+| `~/.agents/skills/<nombre>/SKILL.md` | Compartida con otros agentes compatibles |
+
+Precedencia: proyecto → global → paquete → builtin. Una skill de proyecto con el
+mismo nombre que una builtin la sustituye.
+
+## Escribir la descripción
+
+Es la parte que más se falla. La `description` no describe la skill: describe
+**cuándo usarla**. El modelo la lee sin haber leído el cuerpo.
+
+Mal: `Herramienta para bases de datos.`
+Bien: `Use when reviewing database migrations: checks for missing rollbacks, non-concurrent index creation, and locking DDL on large tables.`
+
+## Dos reglas que una skill de Ada NO debe romper
+
+Esto es lo específico de Ada, y no está en ningún otro sitio:
+
+1. **Nunca instruyas a un subagente para que llame a `goal_*`, `workflow` o
+   `graph_add_nodes`.** No es una convención: esas tools no existen en el
+   registro de un subagente, así que la instrucción fallaría. La orquestación
+   vive solo en la sesión principal, a propósito.
+
+2. **Nunca declares algo como hecho sin una cita `fichero:línea`.** El juez del
+   goal y los gates del grafo exigen evidencia observada. Una skill que enseñe
+   al modelo a afirmar "ya está arreglado" sin cita está enseñándole a saltarse
+   la propiedad central del producto.
+
+## Plantilla
+
+```markdown
+---
+name: revisar-migraciones
+description: Use when reviewing database migration files, before merging schema changes, or when the user mentions Alembic/Flyway/Prisma migrations. Checks rollback coverage, index concurrency and locking DDL.
+---
+
+# Revisar migraciones
+
+## Cuándo aplica
+Ficheros bajo `migrations/`, `alembic/versions/` o `prisma/migrations/`.
+
+## Pasos
+1. Comprueba que cada `up` tiene su `down`. Cita `fichero:línea` de los que no.
+2. Marca los `CREATE INDEX` sin `CONCURRENTLY` sobre tablas de >1M filas.
+3. Marca el DDL que toma un lock exclusivo en horario de producción.
+
+## Salida
+Una lista por severidad, cada hallazgo con su cita `fichero:línea`. Si no hay
+hallazgos, dilo — no rellenes.
+```
+
+## Empaquetar un workflow ya ejecutado
+
+Si lo que quieres reutilizar es un *procedimiento* que ya corrió, no escribas
+una skill: guarda el run.
+
+```
+workflow save-as-skill <runId> <nombre>
+```
+
+Eso guarda el script que **se ejecutó de verdad**, con su procedencia (runId,
+args, resultado) en la cabecera. Solo acepta runs completados. Es más fiable que
+una skill escrita a mano describiendo lo que uno cree que hizo.

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
 	"name": "@hoilab/ada-cli",
-	"version": "0.85.1",
+	"version": "0.85.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@hoilab/ada-cli",
-			"version": "0.85.1",
+			"version": "0.85.0",
 			"license": "MIT",
 			"dependencies": {
 				"@agentclientprotocol/sdk": "1.3.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hoilab/ada-cli",
-  "version": "0.85.1",
+  "version": "0.85.3",
   "description": "Ada CLI - coding agent CLI (rebranded fork of pi.dev) with read, bash, edit, write tools and session management",
   "type": "module",
   "piConfig": {