AGENT SKILL

pdf-professional-creator

Experto en generación de PDFs empresariales profesionales (contratos, facturas, informes, propuestas, CVs, NDAs, whitepapers, business plans) usando la clase PDFProTools con reportlab y 8 paletas corporativas.

License 许可
MIT
最近更新
2026-07-16
Stars
★ 7
Forks
0

01 前言 Front Matter

name
pdf-professional-creator
description
Experto en generación de PDFs empresariales profesionales (contratos, facturas, informes, propuestas, CVs, NDAs, whitepapers, business plans) usando la clase PDFProTools con reportlab y 8 paletas corporativas.

03 SKILL.md 正文

PDF Professional Creator (Nivel Empresarial)

Esta habilidad te permite generar PDFs de calidad editorial real, no solo documentos con un título. Usa la clase PDFProTools del módulo tools/pdf_pro_tools.py (basada en reportlab) con 9 funciones create_*() y 8 paletas corporativas.

Capacidades (9 tipos de documento)

1. pdf_create_contract — Contratos profesionales

  • Tipos soportados: services (servicios), employment (empleo), nda (NDA), lease (arrendamiento), sales (compraventa), partnership (asociación).
  • Estructura: header corporativo, partes identificadas, objeto del contrato, obligaciones, duración, terminación, jurisdicción, espacios de firma con líneas, fecha de firma.
  • Args clave: output_path, contract_type, party_a, party_b, terms (lista de cláusulas), effective_date, duration, jurisdiction.

2. pdf_create_invoice — Facturas con tabla

  • Header corporativo con logo, datos del emisor.
  • Tabla con: concepto, cantidad, precio unitario, subtotal, IVA, total destacado.
  • Datos del cliente, número de factura, fecha, condiciones de pago.
  • Args clave: output_path, invoice_number, date, due_date, from_company, to_client, line_items (lista de dicts), tax_rate, currency, notes.

3. pdf_create_report — Informes con TOC

  • Portada con título, subtítulo, autor, fecha, logo.
  • Tabla de contenidos (TOC) generada automáticamente.
  • Secciones jerárquicas (H1/H2/H3) con numeración.
  • Tablas estilizadas + gráficos matplotlib embebidos.
  • Conclusiones y referencias al final.
  • Args clave: output_path, title, author, sections (lista de dicts con heading, level, content, tables, charts).

4. pdf_create_proposal — Propuestas comerciales

  • Hero section con título impactante.
  • Resumen ejecutivo.
  • Deliverables con descripción y timeline.
  • Pricing tiers (básico/pro/enterprise).
  • Términos y condiciones.
  • CTA claro con contacto.
  • Args clave: output_path, client_name, project_title, deliverables, timeline_weeks, pricing_tiers, terms.

5. pdf_create_resume — Currículums Vitae

  • Sidebar con datos de contacto, habilidades, idiomas, certificaciones.
  • Main con experiencia, educación, proyectos destacados.
  • Layout moderno a una o dos páginas.
  • Args clave: output_path, name, contact, summary, experience, education, skills, languages, certifications.

6. pdf_create_letter — Cartas formales

  • Header con remitente, fecha, destinatario.
  • Asunto, saludo, cuerpo con párrafos, despedida, firma.
  • Tono formal o informal configurable.
  • Args clave: output_path, from_name, from_address, to_name, to_address, date, subject, body, signature.

7. pdf_create_nda — Acuerdos de Confidencialidad

  • Header con partes y propósito.
  • Cláusulas completas: definición de información confidencial, excepciones, plazo, jurisdicción, penalización.
  • Firmas con líneas y testigos opcionales.
  • Args clave: output_path, disclosing_party, receiving_party, purpose, duration_years, jurisdiction.

8. pdf_create_business_plan — Planes de Negocio

  • Executive summary, mercado objetivo, análisis competitivo, modelo de ingresos, equipo, proyecciones financieras, roadmap.
  • Args clave: output_path, company_name, executive_summary, market_analysis, competitors, revenue_model, team, financials, roadmap_quarters.

9. pdf_create_whitepaper — Whitepapers Técnicos

  • Abstract, problema, solución, arquitectura, implementación, benchmarks, referencias numeradas estilo académico.
  • Args clave: output_path, title, abstract, sections, references (lista de citas).

Funciones auxiliares

  • pdf_create_from_json(output_path, data): detecta el tipo por las claves del dict y delega. Ideal para integración con agentes.
  • pdf_list_templates(): lista plantillas pre-rellenadas (contract_services, nda_standard, invoice_template, report_template, proposal_template, letter_formal).
  • pdf_get_template(name): devuelve el JSON de una plantilla para personalizarla.
  • pdf_list_palettes(): muestra las 8 paletas disponibles.
  • pdf_render_chart(data, labels, title, chart_type): genera gráfico matplotlib (bar, line, pie, scatter) para embeber en informes.

Paletas disponibles (8)

  1. professional_blue: azul corporativo (#1e3a8a) - banca, finanzas, legal
  2. corporate_gray: gris carbón (#374151) - consultoría, corporativo
  3. tech_modern: cian eléctrico (#0891b2) - tech, SaaS, startups
  4. elegant_gold: dorado (#b45309) - lujo, hospitality, premium
  5. medical_clean: azul médico (#0e7490) - salud, farma
  6. legal_classic: verde legal (#166534) - bufetes, notaría
  7. creative_violet: violeta (#7c3aed) - agencias, marketing, diseño
  8. eco_green: verde natural (#15803d) - sostenibilidad, ONG

Workflow de uso

Paso 1: Identifica el tipo de documento

Analiza la solicitud del usuario y determina cuál de los 9 tipos encaja. Si el usuario dice "contrato" pero no especifica el subtipo, elige services por defecto.

Paso 2: Recopila la información necesaria

Cada tipo requiere args específicos. Si faltan datos, pregunta al usuario O usa placeholders claros (ej. "[NOMBRE_EMPRESA]"). NO alucines datos críticos como CIF/NIF/RFC, importes o fechas.

Paso 3: Llama a la función pdf_create_* correspondiente

{
  "action": "pdf_create_invoice",
  "args": {
    "output_path": "C:\\Users\\COMPUMAX\\Downloads\\factura_001.pdf",
    "invoice_number": "INV-2026-001",
    "from_company": {"name": "ACME SL", "cif": "B12345678", "address": "Calle Mayor 1, Madrid"},
    "to_client": {"name": "Cliente SA", "address": "Av. Diagonal 100, Barcelona"},
    "line_items": [
      {"concept": "Servicios de consultoría", "quantity": 10, "unit_price": 150.00}
    ],
    "tax_rate": 0.21,
    "currency": "EUR"
  }
}

Paso 4: Verifica el resultado

  • Comprueba que el archivo existe con task_coord_verify_outputs o listando el directorio.
  • El PDF generado tiene header, footer corporativo, número de página, tipografía consistente.

Reglas de oro

  • USA SIEMPRE PDFProTools para PDFs (9 funciones create_*).
  • NO generes PDFs con write_file plano (eso es amateur).
  • NO uses fpdf2 con scripts desde cero salvo que la skill lo pida explícitamente (es inferior a reportlab).
  • NO inventes datos críticos: si falta CIF, dirección o importe, pregunta o usa placeholders [COMPLETAR].
  • Resuelve rutas absolutas con task_coord_resolve_path antes de guardar (ej. "descargas" → C:\Users\COMPUMAX\Downloads).
  • Elige la paleta según el sector del cliente (no pongas medical_clean en un contrato de una startup tech).
  • Verifica que el archivo se creó antes de informar al usuario que "el PDF está listo".

Ejemplo: crear un contrato de servicios

{
  "action": "pdf_create_contract",
  "args": {
    "output_path": "C:\\Users\\COMPUMAX\\Downloads\\contrato_servicios_2026.pdf",
    "contract_type": "services",
    "party_a": {"name": "ACME Consulting SL", "cif": "B12345678"},
    "party_b": {"name": "Tech Startup SRL", "cif": "B87654321"},
    "terms": [
      "Asesoramiento técnico en arquitectura cloud",
      "Reuniones semanales de seguimiento",
      "Entrega de informes mensuales",
      "Confidencialidad sobre la información del cliente"
    ],
    "duration": "12 meses",
    "effective_date": "2026-01-15",
    "jurisdiction": "Madrid, España"
  }
}

Anti-patrones

  • ❌ Crear el PDF con write_file + contenido textual plano.
  • ❌ Generar scripts de 200 líneas con fpdf2 cuando PDFProTools ya tiene la función.
  • ❌ Olvidar el header/footer corporativo.
  • ❌ No verificar que el PDF se generó.
  • ❌ Inventar datos del cliente (CIF, dirección, importes).
  • ❌ Usar la misma paleta para todos los documentos sin importar el contexto.

04 同仓库更多 Skills