Fibo Skills
Cuando utilizas un Agent CLI (Claude Code, Codex o cualquier agente compatible con Skills) en el terminal integrado de FiboCode, Fibo Skills enseña a ese agente el flujo de trabajo dirigido por especificaciones de FiboCode. Son opcionales —el terminal funciona sin ellas—, pero al instalarlas el agente obtiene el mismo ciclo brainstorm → spec → plan → execute → sync que sigue FiboCode, de modo que su resultado queda en el sistema documental .fibo/ en vez de alejarse de la base de código.
Los Skills son instrucciones empaquetadas que el agente carga cuando las necesita. Fibo Skills es de código abierto y se instala en tu agente, no en FiboCode.
Repositorio de Skills: github.com/Alenkz12/FiboSkills
El conjunto de skills
Es un único flujo de trabajo, no una colección de comandos inconexos. Las primeras cinco skills se entregan el trabajo de una etapa a otra; las dos últimas funcionan por separado:
| Skill | Etapa | Para qué sirve |
|---|---|---|
fibo-brainstorming | Aclarar la idea | Convierte una intención vaga en una lista de AC aprobada |
fibo-writing-plan | Decidir el enfoque | Produce design.md y plan.md a partir de la spec |
fibo-executing-plan | Escribir el código | Ejecuta las tareas del plan una a una y en orden |
fibo-recording-diff | Dejar constancia | Convierte el diff real en un diff.md legible y organizado por hunks |
fibo-conventions | Mantener las reglas | Un conjunto de reglas para nombres, comentarios, documentación y commit sync |
fibo-code-analysis | Leer el código | Produce el espejo de análisis por niveles file → structure → folder |
fibo-skills-reviewer | Automantenimiento | Audita la redacción de los propios archivos de skills |
fibo-brainstorming — concretar primero el requisito
Se invoca antes de cualquier cambio en el comportamiento visible externamente. Formula una pregunta cada vez (con opciones siempre que sea posible), transforma «quiero una función» en criterios de aceptación con sintaxis EARS y solo escribe spec.md cuando das tu aprobación explícita. No escribe código de producción, no ejecuta pruebas ni confirma cambios: su única función es eliminar la ambigüedad.
fibo-writing-plan — convertir la spec en diseño y tareas
Se invoca cuando la spec está aprobada. Lee spec.md y produce en el mismo directorio design.md (el HOW, con cada decisión de diseño vinculada mediante ↔ AC) y plan.md (una lista donde cada tarea identifica sus AC, archivos y método de verificación). Si la cobertura de AC es inferior al 100 % o una tarea cita un AC inexistente, se niega a escribir en disco.
fibo-executing-plan — ejecutar el plan estrictamente en serie
Ejecuta las tareas de plan.md una por una, nunca en paralelo, para que dos tareas no entren en conflicto sobre los mismos archivos. Cada tarea solo puede modificar los archivos de su lista. Si falla, se detiene y te pregunta si quieres omitir / cancelar / reintentar, en lugar de revertir por su cuenta. Al terminar imprime un informe de implementación y pasa directamente al registro del diff y la sincronización documental.
fibo-recording-diff — hacer legible el cambio
Se invoca después de la implementación. Convierte un diff real en explicaciones por hunk, ordena los archivos modificados en una secuencia de lectura coherente, adjunta a cada hunk un ancla de código y, cuando resulta útil, una vista lógica Mermaid, y explica por qué existe y cómo conecta con la lógica circundante. No cambia ni el código ni los AC.
fibo-conventions — una sola voz para documentos y comentarios
Se aplica al escribir Markdown, añadir comentarios al código o crear contenido bajo .fibo/docs/: uso de Mermaid, formatos de etiquetas code / text / graph, reglas de rutas y nombres, sincronización entre comentarios y código y sincronización documental por lotes previa al commit, con la línea base registrada en .fibo/index.json.
fibo-code-analysis — resultado de análisis estructurado
Se usa para generar el análisis estructurado bajo .fibo/analysis y para comprender o ampliar el propio proceso de análisis de FiboCode: selección de prompts, concurrencia, distribución en disco y prompts por lenguaje. Esta skill y Code Analysis dentro de la aplicación son dos entradas al mismo método de comprensión del código.
fibo-skills-reviewer — revisión de las propias skills
Audita únicamente la redacción de los archivos de skills: contradicciones o lagunas lógicas, referencias poco claras, divergencia por redundancia y notas internas de mantenimiento filtradas. Cambia cómo se expresa una regla, nunca cuál es la regla; si encuentra un conflicto real, se detiene y te deja la decisión.
Instalación: Claude Code
Claude Code lee las skills de un directorio .claude/skills/. El nivel de proyecto las limita a una base de código; el nivel de usuario las habilita en todas partes:
# Project level (recommended: travels with the repo, so team and agent share one rule set)
git clone https://github.com/Alenkz12/FiboSkills .claude/skills
# Or user level (available in every project)
git clone https://github.com/Alenkz12/FiboSkills ~/.claude/skills
Reinicia Claude Code (o inicia una sesión nueva) y las skills fibo-* aparecerán en su lista. Invoca una con /fibo-brainstorming, o simplemente describe tu tarea y deja que el agente elija la etapa adecuada.
Instalación: Codex y otros agentes
Los archivos de skills son Markdown sencillo con frontmatter YAML, por lo que pueden trasladarse entre agentes. Clónalos donde prefieras:
git clone https://github.com/Alenkz12/FiboSkills
- Agentes con un mecanismo nativo de skills — apunta su directorio de skills al clon siguiendo la documentación del agente.
- Agentes que solo leen un archivo de instrucciones — describe en ese archivo (por ejemplo,
AGENTS.md) la ubicación y finalidad de las skills para que el agente las lea en la etapa correcta.
Comprueba que funcionan
Pide al agente algo pequeño en el terminal integrado de FiboCode, por ejemplo «añade una opción de configuración a este repositorio». Si las skills están activas, no editará código de inmediato: abrirá primero la etapa de brainstorming para confirmar los AC y después dejará spec.md, design.md y plan.md bajo .fibo/docs/specs/<feature>/.
Mantenerlas actualizadas
Como las skills están en un git clone, basta una línea para traer la versión más reciente:
cd .claude/skills && git pull
Obtener ayuda
- Consulta el conjunto completo de Skills en github.com/Alenkz12/FiboSkills.
- Haz preguntas en GitHub Discussions.
- Informa de problemas en el issue tracker.