ayush8620/skillsmith

¿Qué hace skillsmith?

Genera habilidades de agente conformes al estándar a partir de una idea de una línea y lintar archivos SKILL.md (reglas de nombre, longitud de descripción y "cuándo usar", límite de compatibilidad, mapa de metadatos, longitud del cuerpo, secretos filtrados). El CLI cli.js sin dependencias, ubicado en la raíz del repositorio de SkillSmith, realiza el trabajo.

Cuándo usar

• El usuario quiere una nueva habilidad para una tarea ("haz una habilidad que…").
• El usuario quiere saber si una carpeta de habilidad o un archivo SKILL.md sigue el estándar, o quiere que se corrija.

Pasos

1. Para validar, ejecuta node <ruta-a-skillsmith>/cli.js validate <directorio-de-habilidad> (se permiten varias carpetas). El código de salida 0 significa válido.
2. Reporta cada error y corrígelos en el SKILL.md del usuario: renombra a nombres en minúsculas con guiones, haz que el nombre de la carpeta coincida con name, mantén description en 1024 caracteres o menos e incluye "Usar cuando…". Luego vuelve a ejecutar el paso 1.
3. Para crear una habilidad, asegúrate de que GEMINI_API_KEY esté configurada (nunca la imprimas), luego ejecuta node <ruta-a-skillsmith>/cli.js new "<qué hace y cuándo usarlo>" --out <directorio-de-habilidades> --author "<nombre>".
4. Muestra al usuario el SKILL.md generado, luego ejecuta el paso 1 en la nueva carpeta. Edita según sea necesario; el CLI nunca sobrescribe un SKILL.md existente.

Ejemplos

• node cli.js validate skills/commitcraft skills/skillsmith
• node cli.js new "Resume un archivo CSV y sugiere gráficos. Úsalo cuando el usuario comparta un .csv" --out ./skills

Notas

• Los campos de nivel superior desconocidos generan una advertencia; los datos personalizados deben ir bajo metadata.
• El estándar recomienda un cuerpo de menos de 500 líneas; mueve documentos largos a references/.