Communitygithub.com

paper-ecosystem

Conjunto de habilidades del agente Claude Code para redactar y revisar artículos académicos (SSRN / arXiv / Zenodo / revistas). Incluye una habilidad orquestadora, una habilidad de borrador y 5 subagentes revisores; es el primer repositorio que empaqueta habilidades y agentes juntos mediante install.sh.

¿Qué es paper-ecosystem?

Este skill está diseñado para redactar artículos académicos (position papers, preprints, artículos de revista) siguiendo las reglas del orquestador `paper-ecosystem`. Proporciona una guía completa desde el borrador previo, la estructura de secciones, el formato de resumen y referencias, hasta el proceso de escritura y la puerta de calidad final. Es útil porque unifica todas las fases de la escritura académica en un flujo de trabajo estructurado, garantizando fidelidad a las fuentes originales y consistencia terminológica. Funciona en entornos Claude Code (o compatibles) y se activa al redactar para SSRN, arXiv, Zenodo o revistas. El flujo incluye la creación de un checklist pre-borrador, uso de plantillas de sección, procesos de redacción con revisión paralela por agentes especializados, y una puerta de calidad antes del depósito, todo basado en reglas canónicas del orquestador.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add shimo4228/claude-skill-paper-ecosystem

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

paper-writing — Procedimiento para borradores de artículos académicos

Skill que organiza el procedimiento de borrador de artículos académicos (position paper, preprint, artículo de revista) siguiendo las reglas principales del orquestador paper-ecosystem.

Cuándo activarlo

  • Redactar un artículo para SSRN / arXiv / Zenodo / revista
  • Extraer un artículo a partir de ensayos existentes, ADR o historial de implementación
  • Después de definir el esquema de un position paper, comenzar la redacción de cada sección
  • Revisar una preimpresión v1 → v2 (cuando implique reescritura significativa)

Fuera de activación

  • Publicación de blog / ensayo (primario humano, informal) → usar el skill writing-ecosystem
  • llms.txt / FAQ (primario IA) → usar el skill llms-txt-writer
  • README / CHANGELOG (documentación de proyecto) → escribir directamente, sin mediación de skills

Lista de verificación previa al borrador

Antes de comenzar el borrador del artículo, el autor debe completar lo siguiente:

1. Establecer la lista de fuentes primarias

Listar las fuentes primarias que el artículo citará:

  • Ensayos / publicaciones de blog citados (URL + fecha + resumen de 1 línea)
  • ADR / documentos de especificación citados (ruta del repositorio + versión + resumen de 1 línea)
  • Artículos externos citados (Autor AÑO + arXiv ID / DOI + resumen de 1 línea)
  • Estándares / documentos de framework citados (Organización AÑO + ID del estándar)

Cada fuente primaria debe estar disponible para lectura directa al redactar el artículo (acceso a URL, repositorio clonado, PDF descargado).

2. Evitar la dependencia de glosarios / resúmenes

No utilizar glosarios, resúmenes o documentos secundarios del repositorio como fuente de citas en lugar de la fuente primaria. La desviación de los documentos secundarios se propagaría al artículo (detalles: Reglas de Fidelidad de Fuentes del skill paper-ecosystem).

Solo se permite consultar documentos secundarios para:

  • Verificar la coherencia de la definición del término (comprobar que la definición del artículo coincide con la del glosario)
  • Consultar el formato de la lista de referencias (ejemplo de estilo sobre qué campos incluir)

3. Mapeo 1:1 entre afirmación y fuente citada

En la etapa de esquema, escribir cada afirmación central de cada sección en una sola oración y hacer corresponder cada afirmación con una fuente citada en una relación 1:1. Las afirmaciones con un mapeo ambiguo deben resolverse antes de incluirlas en el borrador.

Ejemplo de formato:

§3 afirmación central: "El fallo de redireccionamiento tiene dos modos arquitectónicamente distintos: el principiado (intrínseco a los bucles autónomos) y el artificial (trabajo de flujo redirigido a través de bucles autónomos)."
Fuentes citadas:
- Ensayo 5 (zenn-content/articles-en/react-agent-business-quadrant-2.md, 2026-04-30)
- ADR-0009 §Context (agent-attribution-practice/docs/adr/0009-triage-before-autonomy.md)
- Elish (2019) "Zonas de Amortiguamiento Moral"

4. Preservar la subclasificación

Si la fuente primaria proporciona subformas / subceldas / subtipos para un concepto, estos deben explicitarse en la introducción del término en el artículo. Aplanarlos provoca desviación (detalles: Reglas de Consistencia de Vocabulario del skill paper-ecosystem).


Plantilla de sección (position paper / preprint)

Estructura estándar de 9 secciones:

  1. Portada — Título + subtítulo + autor + ORCID + versión + repositorio complementario + licencia
  2. Resumen — 250-300 palabras, estructura de 3 párrafos (abajo)
  3. Introducción — Planteamiento del problema + avance de la tesis + hoja de ruta de las secciones
  4. [Secciones del cuerpo] — Contribución central del artículo. Aproximadamente 3-6 secciones
  5. Relación con marcos existentes — Breve (1 párrafo a 1 página), relación con marcos competidores
  6. Conclusión — Reafirmación de la tesis + preguntas abiertas
  7. Referencias — Simplificadas al estilo APA
  8. Agradecimientos (opcional)
  9. Apéndice (opcional)

Para artículos de revista, ajustar la numeración de secciones, jerarquía de encabezados y disposición de tablas y figuras según el estilo de la revista.


Estructura del resumen (250-300 palabras)

3 párrafos:

  1. Planteamiento del problema (~70-90 palabras) — Qué fenómeno se aborda y qué falta en el discurso actual
  2. Contribuciones (~120-150 palabras) — 2-3 contribuciones centrales del artículo, cada una con una oración para qué / por qué / cómo
  3. Consecuencia (~60-90 palabras) — Qué aportan las contribuciones a la audiencia del artículo, con mención de preguntas abiertas no resueltas

Palabras clave (5-8) colocadas inmediatamente debajo del resumen.


Formato de referencias (simplificado al estilo APA)

Tipo de fuenteFormato
Artículo de revistaAutor, A. B. (AÑO). Título. *Nombre de la Revista* Vol(Núm): páginas.
Preimpresión arXivAutor, A. B., & Autor, C. D. (AÑO). *Título.* arXiv:NNNN.NNNNN.
Artículo de conferenciaAutor, A. B. (AÑO). Título. En *Título de las Actas* (páginas). Editorial.
Documento de industria / empresaOrganización. (AÑO). *Título.* URL
EstándarOrganización. (AÑO). *ID del Estándar Título.* Editorial.
Repositorio / conjunto de datosAutor, A. B. (AÑO). *Título (Versión).* Plataforma. DOI

Detalles: Reglas de Formato de Citas del skill paper-ecosystem.


Convención multilingüe (opcional)

Si se crea una versión en idioma subordinado (p. ej., traducción al japonés):

  • La versión en inglés es principal; la versión en idioma subordinado no es el texto original
  • Nomenclatura de archivos: <nombre-del-artículo>.md (inglés) + <nombre-del-artículo>.ja.md (japonés)
  • Al modificar el contenido, la versión en inglés se actualiza primero, luego la versión subordinada se actualiza gradualmente
  • Los términos técnicos (Cuadrante / Separación de Fases / nombre del artefacto, etc.) se mantienen en inglés en la versión subordinada, o se escriben en ambos idiomas

Detalles: Convención de Artículos Multilingües del skill paper-ecosystem.


Proceso de escritura (redacción de secciones)

Procedimiento para redactar cada sección:

  1. Escribir la afirmación central de la sección en una sola oración (revisar la salida de la lista de verificación previa al borrador)
  2. La apertura de la sección debe ser concreta: comenzar con un ejemplo, un fenómeno conocido o una cita de la fuente citada; no empezar con un marco abstracto
  3. Colocar la evidencia que respalda la afirmación inmediatamente después (mapeo 1:1 con la cita)
  4. Indicar explícitamente la transición de sección al final de la sección: qué se transfiere a la siguiente sección, qué supuestos de la sección actual se mantienen
  5. Los párrafos subordinados deben alinearse en una dirección: desglosar la afirmación o tratar contraargumentos / alternativas; mezclar ambas direcciones debilita el flujo

Después de redactar cada sección, ejecutar en paralelo los agentes paper-reviewer, source-fidelity-checker y vocabulary-consistency-checker para revisión (detalles: diagrama de flujo Cuándo Usar Qué del skill paper-ecosystem).


Puerta de calidad (antes del depósito)

Justo antes del depósito, verificar lo siguiente:

  • Todas las secciones han pasado la revisión de paper-reviewer
  • Todas las afirmaciones han sido evaluadas como ALINEADAS o PARCIALES por source-fidelity-checker (sin DESVIACIÓN restante)
  • Todos los términos han pasado la verificación de vocabulary-consistency-checker (subclasificación explícitamente introducida)
  • citation-formatter reporta 0 citas huérfanas y mapeo 1:1 entre citas y referencias
  • El recuento de palabras del resumen está dentro del rango estándar de la revista
  • Todos los DOI / arXiv ID / URL son válidos
  • Si existe una versión multilingüe, no hay discrepancia de contenido con la versión en inglés

Para dimensiones detalladas, consultar las 4 secciones de reglas canónicas dentro del skill paper-ecosystem.


Relacionados

  • Skill paper-ecosystem — Texto original de Fidelidad de Fuentes / Consistencia de Vocabulario / Voz Académica / Formato de Citas. Orquestador del que depende este skill
  • Agente paper-reviewer — Revisión estructural después de redactar la sección
  • Agente source-fidelity-checker — Verificación de coherencia entre cita y afirmación después de redactar la sección
  • Agente vocabulary-consistency-checker — Verificación de consistencia terminológica después de redactar la sección
  • Agente citation-formatter — Puerta final de citas y referencias antes del depósito
  • Skill writing-ecosystem — Para publicaciones de blog / ensayos; no este skill sino aquel
  • Skill llms-txt-writer — Para documentación orientada a IA; no este skill sino aquel

Skills relacionados