npm package: @jesusamador/skills-ai
Description: CLI to install AI coding skills and agents into your projects
Author: Jesus Amador
Latest version: 1.0.1

[![npm version](https://img.shields.io/npm/v/@jesusamador/skills-ai.svg)](https://www.npmjs.com/package/@jesusamador/skills-ai)
[![npm downloads](https://img.shields.io/npm/dt/@jesusamador/skills-ai.svg)](https://www.npmjs.com/package/@jesusamador/skills-ai)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://gitlab.com/jesusamador/skills-ia/-/merge_requests)
[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22.0.0-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
[![Zero Dependencies](https://img.shields.io/badge/dependencies-0-blue.svg)](https://www.npmjs.com/package/@jesusamador/skills-ai)

# @jesusamador/skills-ai

**Skills y agentes de IA listos para usar en tus proyectos.** Una coleccion curada de skills y agentes especializados para potenciar tu flujo de desarrollo con asistentes de IA.

## Instalacion rapida

```bash
# Listar skills y agentes disponibles
npx @jesusamador/skills-ai@latest --list

# Instalar un skill
npx @jesusamador/skills-ai@latest --skill nestjs-clean-architecture

# Instalar un agente
npx @jesusamador/skills-ai@latest --agent tech-lead-architect

# Instalar varios a la vez
npx @jesusamador/skills-ai@latest --skill nestjs-clean-architecture nestjs-testing-patterns gof-design-patterns

# Destino personalizado (default: .claude/)
npx @jesusamador/skills-ai@latest --skill nestjs-clean-architecture --dest .cursor
```

## Que incluye

| Componente | Descripcion | Ejemplos |
|-----------|-------------|----------|
| **Skills** | Referencias de conocimiento con patrones, convenciones y checklists | Clean Architecture, patrones de testing, patrones de diseno, troubleshooting |
| **Agentes** | Roles de IA especializados con expertise de dominio | Arquitecto, ingeniero de tests, code reviewer, ingeniero de refactoring |

## Skills disponibles

| Skill | Descripcion |
|---|---|
| `nestjs-clean-architecture` | Clean Architecture 4 capas, DDD, CQRS, Ports & Adapters |
| `nestjs-testing-patterns` | Unit tests con Jest, mocks, BDD con Cucumber |
| `nestjs-troubleshooting` | Debugging: Prisma, NestJS DI, Jest |
| `code-review-checklists` | Checklists de arquitectura, performance, seguridad |
| `gof-design-patterns` | 22 patrones GoF con guia de seleccion |
| `event-driven-patterns` | Domain events, Transactional Outbox, SQS workers |
| `aws-integration-patterns` | S3, SQS, Secrets Manager, Cognito via ports & adapters |
| `prisma-database-patterns` | Schema design, migraciones, query optimization |
| `docker-ci-infrastructure` | Docker Compose, CI/CD pipeline, env config |

## Agentes disponibles

| Agente | Rol |
|---|---|
| `tech-lead-architect` | Disena y scaffoldea modulos con Clean Arch + DDD + CQRS |
| `senior-test-engineer` | Genera unit tests, BDD, mocks, builders |
| `senior-code-reviewer` | Revisa arquitectura, DDD, performance, seguridad |
| `senior-refactoring-engineer` | Migra schemas, extrae VOs, moderniza patrones |

## Como funciona

El CLI copia los archivos de skills y agentes en tu proyecto:

```
tu-proyecto/
  .claude/                         ← destino por defecto
    skills/
      nestjs-clean-architecture/   ← skill instalado
    agents/
      tech-lead-architect.md       ← agente instalado
```

Para actualizar un skill, simplemente ejecuta el comando de nuevo — sobreescribe los archivos existentes.

Usa `--dest` para instalar en un directorio diferente (e.g., `.cursor`, `.ai`, o cualquier ruta personalizada).

## Opciones

| Flag | Descripcion |
|---|---|
| `--list` | Lista todos los skills y agentes disponibles |
| `--skill <nombre> [nombre...]` | Instala uno o mas skills |
| `--agent <nombre> [nombre...]` | Instala uno o mas agentes |
| `--dest <ruta>` | Directorio destino (default: `.claude`) |
| `--help` | Muestra la ayuda |

## Requisitos

- Node.js >= 22.0.0
- Zero dependencias externas

## Licencia

MIT