angular-agents-skills 1.1.0 → 1.1.1

package/README.md

@@ -1,275 +1,106 @@
 # angular-agents-skills
 
-> Instala conocimiento Angular production-ready en tu agente de AI coding.
+[![npm version](https://img.shields.io/npm/v/angular-agents-skills.svg)](https://www.npmjs.com/package/angular-agents-skills)
+[![license](https://img.shields.io/npm/l/angular-agents-skills.svg)](https://github.com/)
 
-Agents y skills definidos una sola vez, instalados en OpenCode, Claude Code, Codex, Cursor, Copilot o cualquier herramienta futura. Sin duplicar configuración. Sin depender de un vendor.
+> Instala conocimiento Angular production-ready como archivos `.md` / `.mdc` directamente en tu herramienta de AI.
 
----
-
-## Architecture
-
-```
-angular-agents-skills/
-├── agents/                          # Definiciones universales de agents
-│   ├── angular-architect/
-│   │   ├── agent.md                 # Instrucciones (markdown puro)
-│   │   └── configs/                 # Configuración por herramienta AI
-│   │       ├── opencode.yaml
-│   │       ├── claude.yaml
-│   │       ├── codex.yaml
-│   │       ├── cursor.yaml
-│   │       └── copilot.yaml
-│   ├── angular-migrator/
-│   │   ├── agent.md
-│   │   └── configs/
-│   └── angular-reviewer/
-│       ├── agent.md
-│       └── configs/
-├── skills/                          # Conocimiento Angular reutilizable
-│   ├── architecture/
-│   ├── components/
-│   ├── libraries/
-│   ├── performance/
-│   ├── quality/
-│   └── reactivity/
-├── adapters/                        # Conversores de formato por herramienta
-│   ├── opencode/
-│   ├── claude/
-│   ├── codex/
-│   ├── cursor/
-│   └── copilot/
-└── src/                             # CLI y lógica core
-    ├── cli.ts
-    ├── registry.ts
-    └── types.ts
-```
-
-### Universal Agents
-
-Cada agent es un directorio con un `agent.md` (instrucciones en markdown puro) y un directorio `configs/` con archivos YAML por cada herramienta AI. Esta es la fuente de verdad. Los agents nunca dependen de ninguna herramienta específica.
-
-### Skills
-
-Skills son módulos de conocimiento Angular reutilizables. Cada skill es un `SKILL.md` dentro de una categoría. Los agents referencian los skills relevantes para ejecutar sus tareas.
-
-### Adapters
-
-Adapters transforman agents universales al formato específico de cada herramienta:
-
-| Adapter | Formato de Salida | Path de Instalación |
-|---|---|---|
-| `opencode` | Markdown + YAML frontmatter | `.opencode/agents/` |
-| `claude` | Markdown + YAML frontmatter | `.claude/agents/` |
-| `codex` | TOML | `.codex/agents/` |
-| `cursor` | MDC (Markdown Custom) | `.cursor/rules/` |
-| `copilot` | Markdown con header | `.github/` |
-
-Agregar una nueva herramienta AI solo requiere crear un nuevo archivo adapter — sin modificar agents ni la lógica core.
-
----
-
-## Installation
-
-### CLI Global
-
-```bash
-npm install -g angular-agents-skills
-```
-
-### Como dependencia del proyecto
-
-```bash
-npm install angular-agents-skills
-```
-
-### Node.js >= 18.0.0 requerido
+Configura una sola vez y distribuye a **Cursor**, **Claude Code**, **OpenCode**, **Copilot** o **Codex** sin dependencias en tu proyecto.
 
 ---
 
-## Usage
+## ⚡ Quick Start
 
-### Instalar un agent para una herramienta
+Ejecuta directamente con `npx` (sin instalación previa):
 
 ```bash
-# OpenCode
-npx angular-agents-skills agent angular-architect --ai opencode
+# Ver catálogo disponible
+npx angular-ai list agents
+npx angular-ai list skills
 
-# Claude Code
-npx angular-agents-skills agent angular-architect --ai claude
+# Instalar un agente (ej. Cursor)
+npx angular-ai agent angular-architect --ai cursor
 
-# Codex
-npx angular-agents-skills agent angular-architect --ai codex
-
-# Cursor
-npx angular-agents-skills agent angular-architect --ai cursor
-
-# Copilot
-npx angular-agents-skills agent angular-architect --ai copilot
+# Instalar una skill (ej. Claude Code)
+npx angular-ai skill signals-state-management --ai claude
 ```
 
-### Instalar un agent para todas las herramientas
-
-```bash
-npx angular-agents-skills agent angular-architect --all
-```
+## 🎯 Supported AI Tools & Destinations
 
-### Instalar una skill
+| Herramienta | `--ai` | Formato | Ruta por Defecto |
+| :--- | :--- | :--- | :--- |
+| **Cursor** | `cursor` | `.mdc` | `.cursor/rules/` |
+| **Claude Code** | `claude` | `.md` | `.claude/agents/` |
+| **OpenCode** | `opencode` | `.md` | `.opencode/agents/` |
+| **Codex** | `codex` | `.toml` | `.codex/agents/` |
+| **Copilot** | `copilot` | `.md` | `.github/` |
 
-```bash
-npx angular-agents-skills skill signals-state-management --ai opencode
-npx angular-agents-skills skill defer-blocks --all
-```
+## 📖 Usage
 
-### Directorio personalizado
+### Agents
 
 ```bash
-npx angular-agents-skills agent angular-architect --ai opencode --target ./my-agents
-npx angular-agents-skills skill signals-effects --ai claude --target ./my-skills
-```
+# Para una herramienta específica
+npx angular-ai agent <name> --ai <tool>
 
-### Listar recursos disponibles
+# Para todas las herramientas soportadas
+npx angular-ai agent <name> --all
 
-```bash
-npx angular-agents-skills list agents
-npx angular-agents-skills list skills
-npx angular-agents-skills list adapters
+# En un directorio personalizado
+npx angular-ai agent <name> --ai <tool> --target ./custom-dir
 ```
 
----
-
-## Available Agents
+## 🤖 Available Agents
 
 | Agent | Descripción | Triggers |
-|---|---|---|
-| `angular-architect` | Genera componentes, servicios y libraries siguiendo convenciones del proyecto y mejores prácticas. Usa signal-based inputs/outputs, standalone components, functional inject(). | create component, generar, scaffold, crear servicio, nueva library |
-| `angular-migrator` | Migra código Angular legacy a patrones modernos: template syntax (@if/@for/@switch), signals, standalone components, host bindings. Respeta funcionalidad existente. | migrate, migrar, convertir a signals, modernizar, upgrade |
-| `angular-reviewer` | Revisa PRs y código contra una checklist de performance, reactivity, arquitectura y testing. Genera reporte estructurado con blockers y sugerencias. | review, revisar, code review, PR review, check |
+| :--- | :--- | :--- |
+| `angular-architect` | Genera componentes, servicios y libraries siguiendo convenciones modernas: Signal inputs/outputs, standalone components e `inject()`. | `create component`, `generar`, `scaffold`, `crear servicio`, `nueva library` |
+| `angular-migrator` | Migra código legacy a patrones modernos: `@if`/`@for`, Signals, standalone components y host bindings. | `migrate`, `migrar`, `convertir a signals`, `modernizar`, `upgrade` |
+| `angular-reviewer` | Revisa PRs y código contra checklists de performance, reactividad, arquitectura y testing. | `review`, `revisar`, `code review`, `PR review`, `check` |
 
 ---
 
-## Available Skills
-
-### Architecture
-
-| Skill | Descripción |
-|---|---|
-| `injection-tokens` | Define y consume `InjectionToken`s tipados para configuración y patrones adapter/strategy |
-| `overlay-animation-lifecycle` | Coordina animaciones CSS de enter/leave para overlays (modal, popover, toast) sin Angular animations |
-
-### Components
-
-| Skill | Descripción |
-|---|---|
-| `dynamic-components` | Crea y monta componentes dinámicamente en runtime con `createComponent()` y `ApplicationRef` |
-| `modern-host-bindings` | Bindings dinámicos de clases, atributos y ARIA via objeto `host` en `@Component` |
-| `content-projection-ng` | Proyección de contenido con `ng-content`, `select` y `ngProjectAs` (slots nombrados y multi-slot) |
-| `viewchild-contentchild-signals` | Query de view/content children con funciones signal-based: `viewChild()`, `contentChild()`, `contentChildren()` |
-
-### Libraries
-
-| Skill | Descripción |
-|---|---|
-| `standalone-component-library` | Scaffold de library Angular standalone con ng-packagr, barrel exports y SCSS |
-| `monorepo-ng-packagr` | Estructura y operación de monorepo multi-library con ng-packagr, path aliases y scripts |
-| `library-versioning` | Actualización de versiones de libraries y manejo de peer dependencies |
-
-### Performance
-
-| Skill | Descripción |
-|---|---|
-| `defer-blocks` | Lazy-load de secciones de template con `@defer`, triggers (viewport, idle, interaction), placeholder, loading, error |
-| `control-flow-syntax` | Control flow nativo del template: `@if`, `@for` (con `track`), `@switch` en vez de directivas estructurales |
-
-### Quality
-
-| Skill | Descripción |
-|---|---|
-| `pr-reviewer` | Review de Pull Requests usando Azure DevOps MCP con reporte estructurado |
-| `vitest-angular-components` | Configuración y tests de componentes standalone con Vitest browser mode + Playwright |
+## 💡 Available Skills
 
 ### Reactivity
+* `signals-state-management`: Gestión de estado reactivo local con `signal()`, `computed()` y `linkedSignal()`.
+* `signals-inputs-outputs`: Migración de `@Input()`/`@Output()` a APIs signal-based: `input()`, `output()` y `model()`.
+* `signals-effects`: Uso correcto de `effect()` y `afterRenderEffect()` para side effects reactivos.
 
-| Skill | Descripción |
-|---|---|
-| `signals-state-management` | Gestión de estado local con `signal()`, `computed()` y `linkedSignal()` |
-| `signals-inputs-outputs` | Migración de `@Input()`/`@Output()` a APIs signal-based: `input()`, `output()`, `model()` |
-| `signals-effects` | Uso correcto de `effect()` y `afterRenderEffect()` para side effects reactivos |
-
----
-
-## Supported AI Tools
-
-| Tool | Formato | Path por Defecto | Notas |
-|---|---|---|---|
-| **OpenCode** | Markdown + YAML frontmatter | `.opencode/agents/` | Soporta `mode` y `permission` en frontmatter |
-| **Claude Code** | Markdown + YAML frontmatter | `.claude/agents/` | Soporta `tools` en frontmatter |
-| **Codex** | TOML | `.codex/agents/` | Instrucciones escapadas en `developer_instructions` |
-| **Cursor** | MDC (Markdown Custom) | `.cursor/rules/` | Incluye `alwaysApply: false` en frontmatter |
-| **GitHub Copilot** | Markdown | `.github/` | Archivo nombrado `copilot-instructions-<agent>.md` |
-
-### Agregar una nueva herramienta AI
-
-1. Crear `adapters/my-tool/index.ts` implementando la interfaz `Adapter`
-2. Registrar en `src/cli.ts` con `registerAdapter(createMyToolAdapter())`
-3. Listo. La CLI ahora soporta `--ai my-tool`
-
----
-
-## Development & Contributing
-
-### Setup
-
-```bash
-# Instalar dependencias
-npm install
-
-# Build
-npm run build
-
-# Watch (dev)
-npm run dev
-
-# Tests
-npm test
-
-# Tests en watch mode
-npm run test:watch
-
-# Type check
-npm run lint
-```
-
-### Adding a new Agent
+### Components
+* `viewchild-contentchild-signals`: Queries reactivas con `viewChild()`, `contentChild()` y `contentChildren()`.
+* `modern-host-bindings`: Enlace de clases, atributos y ARIA vía objeto `host` en `@Component`.
+* `content-projection-ng`: Proyección avanzada con `ng-content`, selectores y `ngProjectAs`.
+* `dynamic-components`: Creación e instanciación dinámica en runtime con `createComponent()` y `ApplicationRef`.
 
-1. Crear directorio `agents/<agent-name>/`
-2. Agregar `agent.md` con instrucciones en markdown puro (sin frontmatter, sin sintaxis de herramienta específica)
-3. Crear `configs/` con un YAML por cada herramienta AI soportada:
+### Performance & Flow
+* `control-flow-syntax`: Control flow nativo del template: `@if`, `@for` (con `track`) y `@switch`.
+* `defer-blocks`: Lazy-loading granular con `@defer` y sus triggers (`viewport`, `idle`, `interaction`, `timer`).
 
-```yaml
-# agents/my-agent/configs/opencode.yaml
-name: my-agent
-description: Descripción del agent
-mode: subagent
-permission:
-  edit: allow
-  bash: ask
-```
+### Quality & Architecture
+* `pr-reviewer`: Review automatizado de Pull Requests con reporte estructurado.
+* `vitest-angular-components`: Configuración y tests de componentes standalone con Vitest Browser Mode.
+* `injection-tokens`: Definición y consumo de `InjectionToken`s tipados para configuración e inyección funcional.
+* `overlay-animation-lifecycle`: Coordinación de ciclo de vida de animaciones CSS de enter/leave para overlays sin Angular animations.
 
-### Adding a new Skill
+### Libraries
+* `standalone-component-library`: Scaffold de library standalone con ng-packagr, barrel exports y SCSS.
+* `monorepo-ng-packagr`: Arquitectura y operación de monorepo multi-library con ng-packagr y path aliases.
+* `library-versioning`: Manejo de versiones semánticas y control de peer dependencies.
 
-1. Crear directorio `skills/<category>/<skill-name>/`
-2. Agregar `SKILL.md` con metadata YAML al inicio y contenido en markdown
+### Crear un nuevo Adapter
 
-### Adding a new Adapter
+Implementa la interfaz `Adapter` en un nuevo archivo:
 
 ```typescript
+// adapters/my-tool/index.ts
 import type { Adapter, AdapterOutput, UniversalAgent } from '../../src/types.js';
 
 export function createMyToolAdapter(): Adapter {
   return {
     name: 'my-tool',
-    description: 'My AI Tool',
-    defaultDir: '.my-tool/agents',
+    description: 'Custom AI Assistant',
+    defaultDir: '.my-tool/rules',
     extension: 'md',
 
     generate(agent: UniversalAgent, config?: Record<string, unknown>): AdapterOutput {
@@ -285,17 +116,39 @@ export function createMyToolAdapter(): Adapter {
     },
   };
 }
-```
 
-Registrar en `src/cli.ts`:
+// registralo en cli.ts 
 
-```typescript
 import { createMyToolAdapter } from '../adapters/my-tool/index.js';
+
 registerAdapter(createMyToolAdapter());
 ```
 
----
+## 🏗️ Architecture & New Adapters
+
+```bash
+angular-agents-skills/
+├── agents/    # Markdown puro + configs YAML
+├── skills/    # Conocimiento clasificado (SKILL.md)
+├── adapters/  # Conversores específicos por AI
+└── src/       # CLI y motor de distribución
+```
+
+## 💻 Development
+### Instalar dependencias
+npm install
+
+### Compilar TypeScript
+npm run build
+
+### Modo watch durante desarrollo
+npm run dev
+
+### Ejecutar tests
+npm test
 
-## License
+### Probar la CLI localmente sin publicar
+node dist/src/cli.js list skills
+node dist/src/cli.js skill defer-blocks --ai cursor
 
-MIT
+> ## Licence MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "angular-agents-skills",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Install Angular agents and skills for AI coding tools",
   "type": "module",
   "bin": {