Xhuk/skillgram

---

name: skillgram-report description: Informa sobre un error de skillgram o una brecha de habilidad faltante con evidencia real: elige el canal, captura el JSON, abre la incidencia.

skillgram-report

Contrato de Activación

Usa esta habilidad cuando se cumpla una de las siguientes condiciones:

• skillgram imprimió ok:false, salió con código 1/2, se colgó, o dijo algo que contradice el disco (registered sin entrada en la configuración del arnés, un enlace que no lleva a ningún sitio, un montaje que reportó cero habilidades mientras el manifiesto tiene alguna).
• un agente necesitaba una capacidad y skillgram missing "<consulta>" respondió found:false.
• una instalación o registro no surtió efecto en el arnés después del reinicio documentado.

No para: "cómo ejecuto X" (lee INSTALL.md), o una idea de funcionalidad sin una brecha observada.

Reglas Estrictas

1. Un error nunca se archiva como una habilidad. Nunca ejecutes propose para ocultar un comportamiento defectuoso.
2. Una brecha nunca se archiva como un error. La ausencia de algo en el centro para una capacidad es una solicitud.
3. Sin evidencia inventada: cada código de salida, ruta y línea JSON proviene de un comando que ejecutaste ahora.
4. Ofusca antes de pegar: tokens, contraseñas, hosts privados, nombres de clientes. Mantén la forma, cambia los valores.
5. Nunca "arregles" skillgram editando a mano una configuración del arnés (config.toml, config.yaml, .claude.json, .cursor/mcp.json) para compensar. Eso oculta el error.
6. Lee la configuración antes de afirmar éxito: <arnés> mcp get skillgram (o mcp list) y skillgram status. Un código de salida no es prueba.

Compuertas de Decisión

Observación	Canal
ok:false, salida no cero, enlace incorrecto, mentira en la salida, colgado	error → bug_report.yml
found:false para una capacidad que realmente necesitabas	solicitud de habilidad → skill_request.yml
Lo que falta es un comando, bandera o comportamiento de skillgram, no una habilidad	error (di "característica" en el título)
Funciona en otra máquina o arnés	anótalo como evidencia; no es una solución
No estás seguro	recoge ambas evidencias y deja que el usuario elija el canal

Pasos de Ejecución

1. Reproduce una vez, manteniendo la línea de comandos exacta. Usa la CLI (skillgram <comando> --json, o python <repositorio>/skillgram.py <comando> --json cuando no esté instalado) y registra el código de salida ($LASTEXITCODE en PowerShell, $? en POSIX).
2. Captura el entorno:
   • skillgram status --json
   • skillgram doctor --json (solo lectura; elimina rutas que no quieras hacer públicas)
   • SO, versión de Python, versión de skillgram, el arnés y el lanzador que usaste (SKILLGRAM_MCP_CLI_<ARNÉS> cuando el que está en PATH no es el correcto).
3. Para cualquier afirmación de registro, captura <arnés> mcp get skillgram (o mcp list) después del comando que afirmó éxito.
4. Para una brecha, captura skillgram missing "<consulta>" --json y skillgram demand --limit 20 (ordena las consultas que nadie pudo responder, de modo que la incidencia y el registro de demanda coincidan).
5. Redacta la incidencia a partir de la plantilla y muéstrasela al usuario antes de publicar. Publícala con gh issue create --repo Xhuk/skillgram --template bug_report.yml (o --body-file <archivo> si llenas el formulario tú mismo), o entrega el texto.

Contrato de Salida

Responde exactamente con:

• canal: bug o skill-request
• evidencia: el comando, el código de salida, una línea JSON
• entorno: SO / Python / skillgram / arnés / lanzador
• esperado en su lugar: una frase, sin especulaciones
• disposición: publicado (con la URL de la incidencia) o dejado como texto para el usuario