tpc-pascal/agent-skills

Escribe informes en uno de dos formatos: estándar internacional o popular en Vietnam. Sintetiza fuentes con citas, mantiene el informe principal conciso y separa los datos de apoyo cuando sea necesario; exporta `.report.md` o `.report.docx`.

¿Qué es agent-skills?

Esta habilidad para agentes de IA, diseñada para plataformas como Claude Code, Cursor o Codex, automatiza la redacción de informes a partir de fuentes recopiladas. Soporta dos formatos exclusivos: el estándar académico internacional, ideal para investigación estructurada con metodología evaluable y citas completas, y el formato popular vietnamita, pensado para explicar hallazgos a un público general en vietnamita, manteniendo precisión en las evidencias. Su flujo de trabajo guía al agente a consultar los requisitos del orquestador, seleccionar una plantilla, y generar un archivo `.report.md` principal con el contenido y los argumentos, mientras separa en archivos auxiliares (`.sources.md`, `.extract.txt`, etc.) los extractos literales, tablas grandes, metadatos técnicos y apéndices no esenciales. Además, prioriza herramientas locales para la generación y verificación offline, verifica la consistencia de las citas, y puede exportar a DOCX o PDF usando herramientas nativas, reportando claramente cualquier limitación.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tpc-pascal/agent-skills/tree/HEAD/skills/research/paper

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Versión en inglés: SKILL.en.md

paper — escribir informes

Esta habilidad redacta informes a partir de fuentes recopiladas. Elige uno de los dos formatos; no combines ambos marcos en un mismo informe.

Dos formatos de informe

FormatoReferenciaUsar cuando
Informe estándar internacionalreferences/report-academic.mdSe necesita una estructura de investigación clara, metodología evaluable y citas completas. Elige la guía según el tipo de estudio; no declares cumplir un estándar sin verificar la lista de verificación correspondiente.
Informe popular vietnamitareferences/report-template.mdSe necesitan explicar los hallazgos a un público general en vietnamita, manteniendo precisión en las evidencias y las limitaciones.

Las reglas generales están en references/output-format.md. Extrae los documentos/medios previamente mediante la habilidad adecuada si es necesario.

Reglas de ejecución

  1. Pregunta al orchestrator los requisitos de entrada; define el formato del informe, la audiencia, el propósito, el idioma y el formato. No preguntes información ya disponible.
  2. Usa únicamente el marco del formato seleccionado. El idioma por defecto sigue los requisitos/contexto; no fuerces bilingüismo.
  3. Mantén el archivo .report.md centrado en el contenido y la argumentación. Coloca extractos literales, tablas de datos grandes, metadatos técnicos, registros de herramientas y apéndices no esenciales en archivos auxiliares separados; conserva las citas necesarias directamente en el informe.
  4. Utiliza herramientas locales cuando sea adecuado. Los informes a partir de fuentes locales deben poder redactarse y verificarse sin conexión; accede a URL/API o servicios externos solo si la fuente o los requisitos necesitan red. No cambies silenciosamente a servicios remotos.
  5. Guarda <nombre_fuente>.report.md junto a la fuente, sin sobrescribir la fuente. Coloca los archivos sidecar con un sufijo claro como .sources.md, .extract.txt, .data.csv, .transcript.md o .diagram.png.
  6. No inventes datos, citas ni números de página. Vincula la fuente a las afirmaciones; distingue entre hechos, observaciones e inferencias cuando la redacción no sea lo suficientemente clara.
  7. Verifica los enlaces de las citas, la coherencia y el contenido del informe. Al exportar a DOCX/PDF, utiliza las herramientas locales disponibles para verificar el texto y las páginas; indica claramente si alguna herramienta no está disponible.
  8. Responde en el mismo idioma que el usuario y menciona el nombre/ruta de todos los archivos creados.

Exportación a DOCX y PDF

Prioriza las herramientas locales ya instaladas. Si se necesita una conversión compleja, consulta la habilidad doc — doc-recipes.md. Verifica la salida con pdfinfo y pdftotext cuando sea posible.

Fuentes de investigación

Las fuentes utilizadas para construir los principios de redacción de informes están documentadas en references/reporting-principles-sources.md; estos son documentos de referencia de la habilidad, no una parte obligatoria que insertar en cada informe.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

tpc-pascal/agent-skills

Vẽ sơ đồ và biểu đồ đẹp cho báo cáo — flowchart/sequence/class/state/ER/gantt bằng Mermaid (kroki.io, PNG), biểu đồ cột/tròn/line bằng matplotlib (uv), output `<tên>.diagram.png` cạnh nguồn để nhúng vào `.report.docx`. Dùng khi báo cáo cần sơ đồ thay cho ASCII, cần biểu đồ dữ liệu, hoặc user yêu cầu "sơ đồ đẹp".

tpc-pascal/agent-skills

Trích xuất và chuyển đổi tài liệu PDF/DOCX/XLSX — lấy text layer (pdftotext), OCR ảnh scan (pdftoppm + tesseract), chuyển markdown (docling), XLSX → CSV (libreoffice headless), ghép/tách/đảo trang (qpdf/pdftk), kiểm tra output bằng pdfinfo + pdftotext. Dùng khi đưa tài liệu và muốn lấy text, OCR bản scan, chuyển định dạng, tách/ghép/trang, hoặc xác minh nội dung đã trích.

tpc-pascal/agent-skills

Xử lý media — ffprobe thông số, ffmpeg cắt/ghép/transcode/GIF, trích frame, tách audio, phụ đề (shift/convert/burn), timecode SMPTE, phát hiện shot, OCR frame/ảnh, tải từ URL (yt-dlp), nhạc (thể loại/mood/BPM/lyrics). Dùng khi đưa video/audio/ảnh/URL media và muốn tóm tắt nội dung, trích text, cắt ghép, làm phụ đề, lấy khung hình, hoặc tải xuống.

tpc-pascal/agent-skills

Điều phối — nhận input, xác định loại, chuyển tiếp tới skill anh em trong repo — doc (tài liệu), media (video/audio/ảnh), paper (báo cáo), web (đọc web/mạng xã hội/tìm kiếm) — và mở cổng câu hỏi bắt buộc trước khi viết báo cáo. Dùng khi chưa biết skill nào xử lý input đang có, hoặc khi cần quy trình phối hợp nhiều skill.

Skills relacionados