theus-cli-linux-arm64 0.2.84

package/vendor/theus-arsenal/skills/evaluacion-academica/SKILL.md

@@ -0,0 +1,165 @@
+---
+name: evaluacion-academica
+description: Evaluación estructurada de trabajos académicos con rúbrica repetible. Cubre artículos,
+  propuestas, revisiones de literatura, secciones de método, calidad de la evidencia, respaldo de
+  citas y retroalimentación de escritura científica.
+---
+
+# Evaluación académica
+
+Usa esta skill para evaluar trabajo académico o científico con una rúbrica repetible.
+
+## Cuándo usarla
+
+- Al revisar un artículo de investigación, una propuesta, un capítulo de tesis o una revisión de literatura.
+- Al comprobar si las afirmaciones están respaldadas por la evidencia citada.
+- Al evaluar metodología, diseño de estudio, análisis o limitaciones.
+- Al comparar dos o más artículos por calidad o relevancia.
+- Al producir retroalimentación estructurada para revisión.
+
+## Alcance de la evaluación
+
+Empieza identificando el artefacto:
+
+- artículo de investigación empírica
+- artículo teórico
+- informe técnico
+- revisión de literatura sistemática o narrativa
+- propuesta de investigación
+- capítulo de tesis o disertación
+- resumen de congreso o artículo corto
+
+Después elige el alcance:
+
+- **integral**: todas las dimensiones de la rúbrica
+- **focalizado**: una o dos dimensiones, por ejemplo método o citas
+- **comparativo**: clasificar varios trabajos contra la misma rúbrica
+
+## Rúbrica
+
+Puntúa cada dimensión aplicable del 1 al 5:
+
+- 5: excelente; claro, riguroso y listo para publicación
+- 4: bueno; necesita mejoras menores
+- 3: adecuado; brechas relevantes pero utilizable
+- 2: débil; necesita revisión sustancial
+- 1: pobre; problemas graves de validez o claridad
+
+Usa `N/A` para las dimensiones que no aplican.
+
+### 1. Problema y pregunta de investigación
+
+- ¿El problema es claro y específico?
+- ¿La contribución es significativa?
+- ¿El alcance y los supuestos son explícitos?
+- ¿La pregunta coincide con la contribución declarada?
+
+### 2. Literatura y contexto
+
+- ¿Se cubre el trabajo previo relevante?
+- ¿El trabajo sintetiza en lugar de solo listar fuentes?
+- ¿Las brechas se identifican con precisión?
+- ¿Hay equilibrio entre fuentes recientes y fundacionales?
+
+### 3. Metodología
+
+- ¿El método responde la pregunta de investigación?
+- ¿Las decisiones de diseño están justificadas?
+- ¿Las variables, conjuntos de datos, participantes o materiales están descritos con claridad?
+- ¿Otro investigador podría reproducir el trabajo?
+- ¿Se reconocen las restricciones éticas y prácticas?
+
+### 4. Datos y evidencia
+
+- ¿Las fuentes de datos son creíbles y apropiadas?
+- ¿El tamaño de muestra o la cobertura del corpus es adecuado?
+- ¿Las decisiones de inclusión, exclusión y preprocesamiento están documentadas?
+- ¿Se discuten los datos faltantes y los riesgos de sesgo?
+
+### 5. Análisis
+
+- ¿Los métodos estadísticos, cualitativos o computacionales son apropiados?
+- ¿Las líneas base y los controles son justos?
+- ¿Se incluyen comprobaciones de incertidumbre, sensibilidad o robustez cuando hacen falta?
+- ¿Se consideran explicaciones alternativas?
+
+### 6. Resultados e interpretación
+
+- ¿Los resultados se presentan con claridad?
+- ¿Las afirmaciones se mantienen dentro de lo que la evidencia permite?
+- ¿Las figuras, tablas y métricas son comprensibles?
+- ¿Los resultados negativos o nulos se manejan con honestidad?
+
+### 7. Limitaciones y amenazas a la validez
+
+- ¿Las limitaciones son específicas en lugar de genéricas?
+- ¿Se abordan los riesgos de validez interna, externa, de constructo y de conclusión?
+- ¿El artículo distingue la especulación de los resultados demostrados?
+
+### 8. Escritura y estructura
+
+- ¿El argumento es fácil de seguir?
+- ¿Las secciones están organizadas en torno a la pregunta de investigación?
+- ¿Las definiciones y la notación son claras?
+- ¿El tono es preciso y académico?
+
+### 9. Citas
+
+- ¿Los artículos citados respaldan las afirmaciones que se les atribuyen?
+- ¿Se usan fuentes primarias cuando es posible?
+- ¿Las revisiones están etiquetadas como revisiones?
+- ¿Los preprints están etiquetados como preprints?
+- ¿Los metadatos y enlaces de las citas son correctos?
+
+## Proceso de revisión
+
+1. Lee el resumen, la introducción, las figuras y la conclusión para identificar la contribución declarada.
+2. Lee métodos y resultados para valorar la calidad de la evidencia.
+3. Contrasta las afirmaciones más fuertes con las fuentes citadas.
+4. Puntúa cada dimensión aplicable.
+5. Separa los bloqueantes críticos de las sugerencias de revisión.
+6. Termina con ediciones concretas siguientes.
+
+## Plantilla de salida
+
+```markdown
+# Evaluación académica: <artefacto>
+
+## Valoración general
+
+- Puntuación global: <1-5 o N/A>
+- Confianza: <alta | media | baja>
+- Resumen: <3-5 oraciones>
+
+## Puntuaciones por dimensión
+
+| Dimensión | Puntuación | Evidencia | Prioridad de revisión |
+| --- | ---: | --- | --- |
+| Problema y pregunta |  |  |  |
+| Literatura y contexto |  |  |  |
+| Metodología |  |  |  |
+| Datos y evidencia |  |  |  |
+| Análisis |  |  |  |
+| Resultados e interpretación |  |  |  |
+| Limitaciones |  |  |  |
+| Escritura y estructura |  |  |  |
+| Citas |  |  |  |
+
+## Problemas críticos
+
+## Revisiones recomendadas
+
+## Verificaciones de evidencia pendientes
+```
+
+## Errores a evitar
+
+- No uses la puntuación como sustituto de la retroalimentación concreta.
+- No penalices un artículo por omitir una dimensión fuera de su alcance.
+- No trates el número de citas, el venue o la reputación del autor como prueba de calidad.
+- No aceptes afirmaciones sin respaldo solo porque aparecen en el resumen.
+
+## Skills relacionadas
+
+- `revision-literatura-cientifica`
+- `base-datos-pubmed`

package/vendor/theus-arsenal/skills/explorador-skills/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: explorador-skills
+description: Busca en fuentes de skills locales, del marketplace, de GitHub y de la web antes de crear
+  una skill nueva. Úsala cuando el usuario quiera crear, construir, bifurcar o encontrar una skill
+  para un flujo de trabajo.
+---
+
+# Explorador de skills
+
+Usa esta skill antes de crear una skill nueva. El objetivo es evitar duplicar trabajo ya existente en la comunidad o el marketplace, verificando siempre cualquier fuente externa antes de adoptarla.
+
+## Cuándo usarla
+
+- El usuario dice "crea una skill", "construye una skill", "haz una skill" o "nueva skill".
+- El usuario pregunta "¿hay una skill para X?" o "¿existe una skill que haga Y?".
+- El usuario describe un flujo de trabajo y estás a punto de sugerir crear una skill nueva.
+- El usuario quiere bifurcar o extender una skill existente.
+
+Si el usuario dice explícitamente que se salte la búsqueda o que cree desde cero, reconócelo y procede con el flujo de creación solicitado.
+
+## Cómo funciona
+
+### Paso 1 - Captura la intención
+
+Extrae:
+
+- La tarea que la skill debe realizar.
+- Las condiciones que disparan su uso.
+- El dominio, las herramientas, los frameworks o las fuentes de datos involucrados.
+- De tres a cinco palabras clave de búsqueda más sinónimos útiles.
+
+### Paso 2 - Busca en fuentes locales
+
+Busca primero en los nombres de skills instaladas y del marketplace. Las fuentes locales son preferibles porque ya forman parte del entorno del usuario.
+
+```bash
+find ~/.theus/skills -maxdepth 2 -name SKILL.md 2>/dev/null | grep -iE "palabra_clave|sinonimo"
+find ~/.theus/plugins/marketplaces -path '*/skills/*/SKILL.md' 2>/dev/null | grep -iE "palabra_clave|sinonimo"
+```
+
+Después busca en las descripciones del frontmatter:
+
+```bash
+grep -RilE "palabra_clave|sinonimo" ~/.theus/skills ~/.theus/plugins/marketplaces 2>/dev/null
+```
+
+### Paso 3 - Busca en fuentes remotas
+
+Usa las herramientas de búsqueda de GitHub y web disponibles. Prefiere consultas concisas:
+
+```bash
+gh search repos "theus skill palabra_clave" --limit 10 --sort stars
+gh search code "name: palabra_clave" --filename SKILL.md --limit 10
+```
+
+Para la búsqueda web, usa como máximo tres consultas dirigidas, por ejemplo:
+
+```text
+"skill" palabra_clave
+"SKILL.md" palabra_clave
+"plugin de skills" palabra_clave
+```
+
+### Paso 4 - Verifica las coincidencias externas
+
+Antes de recomendar cualquier skill externa para adopción o bifurcación:
+
+- Lee el frontmatter y las instrucciones del `SKILL.md`.
+- Busca comandos de shell inesperados, escrituras de archivos, llamadas de red, manejo de credenciales o instalaciones de paquetes.
+- Comprueba si el repositorio parece mantenido.
+- Prefiere copiar a una rama local nueva y revisar el diff antes que editar los originales del marketplace.
+
+### Paso 5 - Ordena los resultados
+
+Ordena los candidatos por:
+
+1. Coincidencia exacta de palabra clave en el nombre de la skill.
+2. Coincidencia de palabra clave o sinónimo en la descripción.
+3. Fuente local instalada o del marketplace.
+4. Fuente de GitHub mantenida con actividad reciente.
+5. Mención solo en la web.
+
+Limita la lista final a 10 resultados.
+
+### Paso 6 - Presenta opciones de decisión
+
+Ofrece al usuario una tabla breve:
+
+| Opción | Significado |
+| --- | --- |
+| Usar la existente | Invocar o instalar una skill coincidente tal cual. |
+| Bifurcar o extender | Copiar la skill más cercana y modificarla. |
+| Crear desde cero | Construir una skill nueva tras confirmar que no hay coincidencia cercana. |
+
+Crea una skill nueva solo después de que el usuario elija esa vía o de que la búsqueda no encuentre ninguna coincidencia cercana.
+
+## Ejemplos
+
+### Tabla de resultados
+
+```markdown
+| # | Skill | Fuente | Por qué coincide | Brecha |
+| --- | --- | --- | --- | --- |
+| 1 | redaccion-articulos | Local | Redacta artículos y guías | No enfocada en notas de versión |
+| 2 | motor-de-contenido | Local | Flujo de contenido multiformato | Más pesada de lo necesario |
+| 3 | blog-writer | GitHub | Skill de blog con commits recientes | Requiere revisión de seguridad |
+```
+
+### Resumen para el usuario
+
+```markdown
+Encontré dos coincidencias locales cercanas y un candidato externo. El mejor
+ajuste es `redaccion-articulos`; cubre la redacción y la revisión, pero no
+incluye la lista de verificación de notas de versión que pediste. Puedo usarla
+tal cual, bifurcarla en una variante de notas de versión, o crear una skill nueva.
+```
+
+## Antipatrones
+
+- No saltes directamente a crear una skill nueva cuando una búsqueda es razonable.
+- No instales skills externas sin leerlas primero.
+- No presentes una lista larga y sin ordenar de coincidencias débiles.
+- No trates las menciones solo en la web como fuentes confiables.
+- No edites los originales instalados del marketplace en su lugar.
+
+## Skills relacionadas
+
+- `buscar-primero` - Flujo general de buscar-antes-de-construir.
+- `inventario-skills` - Audita las skills instaladas por salud, duplicados y brechas.