angular-agents-skills 1.0.1 → 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-ai agent angular-architect --ai opencode
-
-# Claude Code
-npx angular-ai agent angular-architect --ai claude
-
-# Codex
-npx angular-ai agent angular-architect --ai codex
+# Ver catálogo disponible
+npx angular-ai list agents
+npx angular-ai list skills
 
-# Cursor
+# Instalar un agente (ej. Cursor)
 npx angular-ai agent angular-architect --ai cursor
 
-# Copilot
-npx angular-ai 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
+## 🎯 Supported AI Tools & Destinations
 
-```bash
-npx angular-ai agent angular-architect --all
-```
-
-### 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-ai skill signals-state-management --ai opencode
-npx angular-ai skill defer-blocks --all
-```
+## 📖 Usage
 
-### Directorio personalizado
+### Agents
 
 ```bash
-npx angular-ai agent angular-architect --ai opencode --target ./my-agents
-npx angular-ai 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-ai list agents
-npx angular-ai list skills
-npx angular-ai 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/dist/src/cli.js

@@ -1,12 +1,18 @@
-import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, statSync } from 'node:fs';
-import { resolve, join, dirname } from 'node:path';
+#!/usr/bin/env node
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { parse as parseYaml } from 'yaml';
-import { registerAdapter, getAdapter, listAdapters, hasAdapter } from './registry.js';
-import { createOpenCodeAdapter } from '../adapters/opencode/index.js';
 import { createClaudeAdapter } from '../adapters/claude/index.js';
 import { createCodexAdapter } from '../adapters/codex/index.js';
-import { createCursorAdapter } from '../adapters/cursor/index.js';
 import { createCopilotAdapter } from '../adapters/copilot/index.js';
+import { createCursorAdapter } from '../adapters/cursor/index.js';
+import { createOpenCodeAdapter } from '../adapters/opencode/index.js';
+import { getAdapter, hasAdapter, listAdapters, registerAdapter } from './registry.js';
+// Determinar la raíz del paquete npm (subiendo dos niveles desde dist/src/cli.js)
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PACKAGE_ROOT = resolve(__dirname, '..', '..');
 registerAdapter(createOpenCodeAdapter());
 registerAdapter(createClaudeAdapter());
 registerAdapter(createCodexAdapter());
@@ -108,7 +114,11 @@ function installAgent(agentName, ai, agentsDir, targetDir) {
     const agent = loadAgent(agentName, agentsDir);
     const config = loadAgentConfig(agentName, ai, agentsDir);
     const output = adapter.generate(agent, config);
-    const installPath = adapter.getInstallPath(agentName, targetDir);
+    // Asegurar que la ruta base apunte al directorio donde el usuario ejecuta el comando (process.cwd())
+    const resolvedTargetDir = targetDir
+        ? resolve(process.cwd(), targetDir)
+        : resolve(process.cwd(), adapter.defaultDir);
+    const installPath = adapter.getInstallPath(agentName, resolvedTargetDir);
     const dir = dirname(installPath);
     mkdirSync(dir, { recursive: true });
     writeFileSync(installPath, output.content, 'utf-8');
@@ -130,7 +140,10 @@ function installSkill(skillName, ai, skillsDir, targetDir) {
     }
     const skill = loadSkill(skillName, skillsDir);
     const filename = `${skillName}.md`;
-    const base = targetDir || join(adapter.defaultDir, 'skills');
+    // Asegurar que la ruta base apunte al directorio donde el usuario ejecuta el comando (process.cwd())
+    const base = targetDir
+        ? resolve(process.cwd(), targetDir)
+        : resolve(process.cwd(), adapter.defaultDir, 'skills');
     const installPath = join(base, filename);
     const dir = dirname(installPath);
     mkdirSync(dir, { recursive: true });
@@ -147,28 +160,28 @@ function installSkillAll(skillName, skillsDir, targetDir) {
 }
 function printHelp() {
     console.log(`
-angular-ai — Install Angular agents and skills for AI coding tools
+        angular-agents-skills — Install Angular agents and skills for AI coding tools
 
-Usage:
-  npx angular-ai agent <name> --ai <tool> [--target <path>]
-  npx angular-ai agent <name> --all [--target <path>]
-  npx angular-ai skill <name> --ai <tool> [--target <path>]
-  npx angular-ai skill <name> --all [--target <path>]
-  npx angular-ai list agents
-  npx angular-ai list skills
-  npx angular-ai list adapters
+        Usage:
+        npx angular-agents-skills agent <name> --ai <tool> [--target <path>]
+        npx angular-agents-skills agent <name> --all [--target <path>]
+        npx angular-agents-skills skill <name> --ai <tool> [--target <path>]
+        npx angular-agents-skills skill <name> --all [--target <path>]
+        npx angular-agents-skills list agents
+        npx angular-agents-skills list skills
+        npx angular-agents-skills list adapters
 
-Options:
-  --ai <tool>        Target AI tool: ${listAdapters().join(', ')}
-  --all              Install for all available AI tools
-  --target <path>    Custom target directory
+        Options:
+        --ai <tool>        Target AI tool: ${listAdapters().join(', ')}
+        --all              Install for all available AI tools
+        --target <path>    Custom target directory
 
-Examples:
-  npx angular-ai agent angular-architect --ai opencode
-  npx angular-ai skill standalone-component-library --ai claude
-  npx angular-ai agent angular-architect --ai opencode --target ./my-agents
-  npx angular-ai skill signals-state-management --all
-`);
+        Examples:
+        npx angular-agents-skills agent angular-architect --ai opencode
+        npx angular-agents-skills skill standalone-component-library --ai claude
+        npx angular-agents-skills agent angular-architect --ai opencode --target ./my-agents
+        npx angular-agents-skills skill signals-state-management --all
+    `);
 }
 function main() {
     const args = process.argv.slice(2);
@@ -177,10 +190,12 @@ function main() {
         return;
     }
     const command = args[0];
+    const agentsDir = join(PACKAGE_ROOT, 'agents');
+    const skillsDir = join(PACKAGE_ROOT, 'skills');
     if (command === 'list') {
         const type = args[1];
         if (type === 'agents') {
-            const agents = listAgents(resolve('agents'));
+            const agents = listAgents(agentsDir);
             if (agents.length === 0) {
                 console.log('No agents found.');
             }
@@ -193,7 +208,7 @@ function main() {
             return;
         }
         if (type === 'skills') {
-            const skills = listSkills(resolve('skills'));
+            const skills = listSkills(skillsDir);
             if (skills.length === 0) {
                 console.log('No skills found.');
             }
@@ -226,7 +241,6 @@ function main() {
         const allFlag = args.includes('--all');
         const targetIndex = args.indexOf('--target');
         const targetDir = targetIndex !== -1 ? args[targetIndex + 1] : undefined;
-        const agentsDir = resolve('agents');
         if (!allFlag && aiIndex === -1) {
             console.error('Error: specify --ai <tool> or --all');
             process.exit(1);
@@ -260,7 +274,6 @@ function main() {
         const allFlag = args.includes('--all');
         const targetIndex = args.indexOf('--target');
         const targetDir = targetIndex !== -1 ? args[targetIndex + 1] : undefined;
-        const skillsDir = resolve('skills');
         if (!allFlag && aiIndex === -1) {
             console.error('Error: specify --ai <tool> or --all');
             process.exit(1);
@@ -289,5 +302,4 @@ function main() {
     process.exit(1);
 }
 main();
-export { loadAgent, loadAgentConfig, loadSkill, listAgents, listSkills, installAgent, installAgentAll, installSkill, installSkillAll };
-export { registerAdapter, getAdapter, listAdapters, hasAdapter };
+export { getAdapter, hasAdapter, installAgent, installAgentAll, installSkill, installSkillAll, listAdapters, listAgents, listSkills, loadAgent, loadAgentConfig, loadSkill, registerAdapter };

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "angular-agents-skills",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "Install Angular agents and skills for AI coding tools",
   "type": "module",
   "bin": {
-    "angular-ai": "dist/src/cli.js"
+    "angular-agents-skills": "dist/src/cli.js"
   },
   "scripts": {
     "build": "tsc",