git:20260906.7d37dc9 to git:20261015.fac8b7e

18 added, 14 removed. Audit A to A.

---

id: 10-andruia-skill-smith

name: 10-andruia-skill-smith

- description: "Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante."

+ description: "Usar para crear o mejorar una skill de Andru.ia: define entradas y resultados, redacta SKILL.md con ejemplos y límites, valida la estructura y prepara una PR."

category: andruia

risk: safe

source: personal

date_added: "2026-02-25"

---

# 🔨 Andru.ia Skill-Smith (The Forge)

## When to Use

- Esta habilidad es aplicable para ejecutar el flujo de trabajo o las acciones descritas en la descripción general.

+ Usar cuando el usuario solicita crear o mejorar una skill con un objetivo concreto, entradas, resultados y criterios de validación; no para instalar o publicar automáticamente un paquete.

## 📝 Descripción

- Soy el Ingeniero de Sistemas de Andru.ia. Mi propósito es diseñar, redactar y desplegar nuevas habilidades (skills) dentro del repositorio, asegurando que cumplan con la estructura oficial de Antigravity y el Estándar de Diamante.

+ Convertir un objetivo repetible en instrucciones utilizables de Andru.ia, con entradas, resultados y límites concretos. Redactar la skill no la instala ni publica.

## 📋 Instrucciones Generales

- - **Idioma Mandatorio:** Todas las habilidades creadas deben tener sus instrucciones y documentación en **ESPAÑOL**.

- - **Estructura Formal:** Debo seguir la anatomía de carpeta -> README.md -> Registro.

+ - **Idioma Mandatorio:** Redactar en **ESPAÑOL** por defecto, respetando el idioma solicitado por el usuario y las convenciones del repositorio destino.

+ - **Estructura Formal:** Debo seguir la anatomía de carpeta -> SKILL.md -> validación.

- **Calidad Senior:** Las skills generadas no deben ser genéricas; deben tener un rol experto definido.

## 🛠️ Flujo de Trabajo (Protocolo de Forja)

### FASE 1: ADN de la Skill

Solicitar al usuario los 3 pilares de la nueva habilidad:

1. **Nombre Técnico:** (Ej: @cyber-sec, @data-visualizer).

2. **Rol Experto:** (¿Quién es esta IA? Ej: "Un experto en auditoría de seguridad").

3. **Outputs Clave:** (¿Qué archivos o acciones específicas debe realizar?).

### FASE 2: Materialización

Generar el código para los siguientes archivos:

- - **README.md Personalizado:** Con descripción, capacidades, reglas de oro y modo de uso.

- - **Snippet de Registro:** La línea de código lista para insertar en la tabla "Full skill registry".

+ - **SKILL.md Personalizado:** Con descripción, capacidades, reglas de oro y modo de uso.

+ - **Resumen para la PR:** Descripción del objetivo, archivos modificados y validaciones; no editar los registros generados a mano.

### FASE 3: Despliegue e Integración

- 1. Crear la carpeta física en `D:\...\agentic-awesome-skills\skills\`.

- 2. Escribir el archivo README.md en dicha carpeta.

- 3. Actualizar el registro maestro del repositorio para que el Orquestador la reconozca.

+ 1. Localizar la raíz del repositorio y crear `skills/<skill-id>/` con un ID en minúsculas y guiones.

+ 2. Escribir `SKILL.md` siguiendo `docs/contributors/skill-template.md`, con frontmatter y secciones de uso, ejemplos y límites.

+ 3. Leer las instrucciones y `package.json` de la base actual. En AAS, ejecutar `npm run chain`, `npm run validate:references`, `npm run security:docs` y `npm run test` antes de proponer la PR; en otro destino, usar sus comprobaciones vigentes sin inventar comandos.

+ 4. Si una comprobación falla, corregir el origen y repetirla. No debilitar validadores, marcar un ejemplo no ejecutado como probado ni continuar al merge con fallos pendientes. Proponer la PR de fuentes cuando las comprobaciones pasen; los registros generados pertenecen al flujo de sincronización canónica.

## ⚠️ Reglas de Oro

- - **Prefijos Numéricos:** Asignar un número correlativo a la carpeta (ej. 11, 12, 13) para mantener el orden.

- - **Prompt Engineering:** Las instrucciones deben incluir técnicas de "Few-shot" o "Chain of Thought" para máxima precisión.

+ - **Prefijos Numéricos:** Mantener IDs existentes. Para nuevas skills, elegir un ID descriptivo en minúsculas y guiones según el repositorio; no imponer un prefijo numérico de Andru.ia a otros proyectos.

+ - **Prompt Engineering:** Incluir ejemplos de entrada y salida observables y criterios de comprobación. Pedir una explicación breve de decisiones cuando sea útil, sin exigir razonamiento interno privado ni prometer precisión máxima.

## Example

**User request:**

- > Diseña una nueva skill para este repositorio, siguiendo su plantilla, validaciones y convenciones de nombres.

+ > Crea una skill `csv-quality-check` que informe valores ausentes y duplicados sin modificar el CSV.

+ **Diseño ilustrativo:** Entradas: ruta autorizada, delimitador y columnas clave. Resultado: informe con número de filas, valores ausentes por columna y claves repetidas. Ejemplo: las filas `id,name` / `1,Ana` / `1,` producen una clave duplicada y un nombre ausente; el CSV permanece intacto. Un delimitador ambiguo se registra como entrada no resuelta, no como informe limpio. La skill documenta límites de tamaño, privacidad y codificación, y se presenta en una PR con las comprobaciones exigidas por la base actual.

## Limitations

- Use this skill only when the task clearly matches the scope described above.

- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.

- - Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

+ - Crear el texto no prueba que los ejemplos funcionen: verificar los ejemplos ejecutables y los recursos incluidos cuando existan.

+ - No instalar, publicar ni alterar políticas del repositorio como consecuencia implícita de redactar una skill.