theus-cli 0.2.83 → 0.2.84

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

@@ -1,165 +0,0 @@
----
-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

@@ -1,129 +0,0 @@
----
-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.