@ariasbruno/skillbase 0.1.1 → 0.2.0

package/AGENTS.md

@@ -15,8 +15,9 @@ Estas instrucciones aplican a todo el árbol del proyecto (`skillbase`).
 1. Mantener el código en JavaScript ESM (`"type": "module"`).
 2. Evitar dependencias externas salvo necesidad clara.
 3. Toda lógica de negocio va en `src/core.js`; `src/cli.js` sólo parsea/coordina comandos.
-4. Mantener mensajes de CLI en español (consistentes con README actual).
-5. Si agregas o cambias comandos, actualiza:
+4. Toda visualización de estado sucede en `src/cli.js`.
+5. Mantener mensajes de CLI en español (consistentes con README actual).
+6. Si agregas o cambias comandos, actualiza:
    - ayuda en `src/cli.js`
    - sección de comandos en `README.md`
 
@@ -25,6 +26,10 @@ Estas instrucciones aplican a todo el árbol del proyecto (`skillbase`).
 - Basarse en señales del proyecto (`package.json`, `requirements.txt`, etc).
 - Si cambias este comportamiento, documenta el motivo en README.
 
+## Listado
+- `skillbase ls` lista las skills globales.
+- `skillbase ls --project` (o `-p`) lista las instaladas en el proyecto actual (`.agents/skills`).
+
 ## Migración
 - `skillbase migrate` migra desde `~/.agents/skills` a `~/.skillbase/skills`.
 - `skillbase migrate --project` migra desde `.agents/skills` del cwd al mismo destino global.

package/README.md

@@ -4,6 +4,8 @@
 
 `skillbase` es un CLI de Node.js que te permite administrar las skills de tus agentes de Inteligencia Artificial utilizando enlaces simbólicos (symlinks) o instalaciones locales por cada workspace, evitando la saturación del contexto.
 
+![demo](artifacts/skillbase-demo.gif)
+
 ---
 
 ## 🤔 El Problema: Saturación de Contexto (Context Bloat)
@@ -59,7 +61,7 @@ skillbase install
 
 | Comando | Alias | Descripción |
 | :--- | :--- | :--- |
-| `skillbase ls` | `l` | Lista skills instaladas globalmente en `~/.skillbase/skills`. |
+| `skillbase ls [--project]` | `l [-p]` | Lista skills globales o del proyecto con `-p`. |
 | `skillbase init [--hard]` | | Detecta tecnologías y sugiere skills (usa `--hard` para analizar `tags` en `skill.json`). |
 | `skillbase add [<skill>] [-s]` | `a` | Instalar skill global. Sin nombre, abre el **selector interactivo**. `-s` crea symlink. |
 | `skillbase install` | `i` | Instala desde el manifiesto `skillbase.json`. Soporta `-r` (remotas) y `-f` (forzar). |
@@ -75,7 +77,7 @@ skillbase install
 - `-r`, `--remote`: Indica que la operación debe consultar fuentes externas (GitHub o API de skills.sh).
 - `-f`, `--force`: Ignora errores de "ya existe" y sobrescribe archivos/configuraciones.
 - `-k`, `--skill`: Nombre de la skill específica a extraer cuando se instala desde un repositorio GitHub.
-- `-p`, `--project`: En migraciones, indica que el origen es `.agents/skills` del proyecto actual.
+- `-p`, `--project`: En `ls`, lista skills locales. En `migrate`, indica que el origen es `.agents/skills`.
 - `--g`: Flag específica de `remove` para borrar una skill del registro global.
 
 ### ⌨️ Aliases de comandos

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ariasbruno/skillbase",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "CLI para administrar skills locales y remotas entre proyectos",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -3,10 +3,12 @@ import {
   addSkill,
   checkUpdates,
   getGlobalSkillsDir,
+  getProjectSkillsDir,
   initProject,
   installFromManifest,
   installRemoteSkillRef,
   listGlobalSkills,
+  listProjectSkills,
   migrateAgentsSkillsToSkillbase,
   readManifest,
   removeSkill,
@@ -19,8 +21,8 @@ function printHelp() {
 Uso:
   skillbase -h
   skillbase h
-  skillbase ls
-  skillbase l
+  skillbase ls [--project]
+  skillbase l [-p]
   skillbase init [--hard]
   skillbase add <skill> [--sym]
   skillbase add
@@ -38,7 +40,7 @@ Uso:
   skillbase m [--project] [-f]
 
 Descripción breve de comandos:
-  ls        Lista skills instaladas globalmente en ~/.skillbase/skills.
+  ls        Lista skills instaladas globalmente (~/.skillbase/skills) o del proyecto con --project.
   init      Sugiere skills globales según tecnologías del proyecto.
   add       Instala una skill global (o abre selector interactivo sin argumentos).
   install   Instala desde skillbase.json o una skill remota con --remote.
@@ -63,8 +65,8 @@ Notas:
 
 function printCommandList() {
   console.log(`Comandos disponibles:
-- skillbase ls
-- skillbase l
+- skillbase ls [--project]
+- skillbase l [-p]
 - skillbase init [--hard]
 - skillbase add
 - skillbase add <skill> [--sym]
@@ -121,12 +123,23 @@ export async function runCLI(argv) {
 
   switch (command) {
     case 'ls': {
-      const skills = await listGlobalSkills();
-      if (!skills.length) {
-        console.log(`No hay skills globales instaladas en ${getGlobalSkillsDir()}`);
+      const showProject = hasFlag(args, '--project', '-p');
+      if (showProject) {
+        const skills = await listProjectSkills();
+        if (!skills.length) {
+          console.log(`No hay skills instaladas localmente en ${getProjectSkillsDir()}`);
+        } else {
+          console.log(`Skills del proyecto (${getProjectSkillsDir()}):`);
+          skills.forEach((skill) => console.log(`- ${skill}`));
+        }
       } else {
-        console.log(`Skills globales (${getGlobalSkillsDir()}):`);
-        skills.forEach((skill) => console.log(`- ${skill}`));
+        const skills = await listGlobalSkills();
+        if (!skills.length) {
+          console.log(`No hay skills globales instaladas en ${getGlobalSkillsDir()}`);
+        } else {
+          console.log(`Skills globales (${getGlobalSkillsDir()}):`);
+          skills.forEach((skill) => console.log(`- ${skill}`));
+        }
       }
       return;
     }
@@ -142,7 +155,6 @@ export async function runCLI(argv) {
         console.log('No se encontraron skills compatibles en ~/.skillbase/skills.');
         return;
       }
-      console.log(`Skills sugeridas: ${result.suggested.join(', ')}`);
       if (result.cancelled) {
         console.log('Selección cancelada.');
         return;
@@ -158,7 +170,10 @@ export async function runCLI(argv) {
     case 'add': {
       if (!maybeSkill) {
         const result = await addSkillsInteractive({ sym: hasFlag(args, '--sym', '-s') });
-        if (result.cancelled) return;
+        if (result.cancelled) {
+          console.log('Selección cancelada.');
+          return;
+        }
         if (!result.selected.length) {
           console.log('No se seleccionaron skills para instalar.');
           return;

package/src/core.js

@@ -36,6 +36,13 @@ export async function listGlobalSkills() {
   return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
 }
 
+export async function listProjectSkills(cwd = process.cwd()) {
+  const projectSkillsDir = getProjectSkillsDir(cwd);
+  if (!(await exists(projectSkillsDir))) return [];
+  const entries = await fs.readdir(projectSkillsDir, { withFileTypes: true });
+  return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
+}
+
 async function copyDir(src, dst) {
   await fs.cp(src, dst, { recursive: true, force: true });
 }
@@ -237,7 +244,6 @@ async function selectSkillsFromList(skills, { title, requireTTYMessage } = {}) {
   output.write('\n');
 
   if (outcome.cancelled) {
-    output.write('\nSelección cancelada.\n');
     return { selected: [], cancelled: true };
   }