Skip to content

2654400439/Paper2Seminar / skills/paper-ppt-orchestrator

paper-ppt-orchestrator

Verified

Build complete fixed-layout academic-paper presentations from a PDF with bundled PPTX and one-page HTML templates. Use for full paper reading, complexity-aware slide budgeting, subsection coverage mapping, figure extraction, TikZ or Matplotlib evidence visuals, deterministic PPTX assembly, and final QA. Trigger for requests to turn a paper PDF into a discussion-group deck, especially 12-16+ page systems, security, networking, or measurement papers.

FileKindSize
SKILL.mdskill md17.9 KB
agents/openai.yamlconfig296 B
assets/one-page-summary.htmlother7.8 KB
assets/seminar-template.pptxbinary572.7 KB
references/content-design.mdmarkdown5.7 KB
references/data-viz.schema.jsonconfig2.9 KB
references/deck-plan.schema.jsonconfig8.5 KB
references/deck-sizing.mdmarkdown3.4 KB
references/environment-compatibility.mdmarkdown2.8 KB
references/feature-registry.jsonconfig1.4 KB
references/figure-extraction.mdmarkdown5.1 KB
references/job-request.defaults.jsonconfig1.6 KB
references/job-request.schema.jsonconfig7.5 KB
references/one-page-template.mdmarkdown3.1 KB
references/qa-gates.mdmarkdown10.0 KB
references/speaker-notes.mdmarkdown3.1 KB
references/template-contract.mdmarkdown5.1 KB
references/tikz-layout.mdmarkdown12.2 KB
references/visual-selection.mdmarkdown6.5 KB
references/workflow.mdmarkdown9.8 KB
requirements-doclayout.txtmarkdown238 B
requirements-ui.txtmarkdown39 B
requirements.txtmanifest68 B
scripts/apply_speaker_notes.pyscript6.1 KB
scripts/build_ppt.pyscript16.3 KB
scripts/crop_author_block.pyscript7.9 KB
scripts/crop_image_region.pyscript2.4 KB
scripts/export_pptx_pages.ps1script1.3 KB
scripts/extract_paper_assets.pyscript22.3 KB
scripts/job_request.pyscript17.1 KB
scripts/make_contact_sheet.pyscript4.0 KB
scripts/paper_ppt.pyscript17.1 KB
scripts/preflight_capabilities.pyscript8.3 KB
scripts/render_data_viz.pyscript14.6 KB
scripts/render_deck_overview.pyscript2.4 KB
scripts/render_one_page_html.pyscript13.4 KB
scripts/render_readability.pyscript4.1 KB
scripts/update_qa_status.pyscript10.1 KB
scripts/validate_deck_plan.pyscript33.9 KB
webapp/__init__.pyscript49 B
webapp/backend.pyscript14.5 KB
webapp/job_runner.pyscript3.2 KB
webapp/streamlit_app.pyscript17.3 KB

references/deck-plan.schema.json

View on GitHub
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "urn:paper-ppt-orchestrator:schema:deck-plan:0.1",
  "title": "Paper2Seminar deck plan",
  "type": "object",
  "additionalProperties": false,
  "required": ["schema_version", "project", "paper", "sections", "slides"],
  "properties": {
    "schema_version": {"const": "0.1"},
    "project": {
      "type": "object",
      "additionalProperties": false,
      "required": ["paper_pdf", "template_pptx", "output_pptx", "one_page_image", "author_visual", "language", "target_minutes", "target_slide_count", "supported_layouts"],
      "properties": {
        "paper_pdf": {"type": "string", "minLength": 1},
        "template_pptx": {"type": "string", "minLength": 1},
        "output_pptx": {"type": "string", "minLength": 1},
        "one_page_image": {"type": "string", "minLength": 1},
        "author_visual": {"type": "string", "minLength": 1},
        "presenter": {"type": "string"},
        "advisor": {"type": "string"},
        "language": {"enum": ["zh-CN", "en-US", "bilingual"]},
        "target_minutes": {"type": "integer", "minimum": 5, "maximum": 120},
        "target_slide_count": {"type": "integer", "minimum": 8, "maximum": 80},
        "final_readability_mode": {"enum": ["off", "overview", "full"], "default": "off"},
        "readability_manifest": {"type": "string", "minLength": 1},
        "speaker_notes": {"$ref": "#/$defs/speaker_notes_config"},
        "speaker_notes_report": {"type": "string", "minLength": 1},
        "supported_layouts": {
          "type": "array",
          "minItems": 1,
          "uniqueItems": true,
          "items": {"const": "content_stacked"}
        }
      }
    },
    "paper": {
      "type": "object",
      "additionalProperties": false,
      "required": ["title_en", "title_cn", "authors", "venue", "year", "contributions"],
      "properties": {
        "title_en": {"type": "string", "minLength": 1},
        "title_cn": {"type": "string", "minLength": 1},
        "authors": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
        "venue": {"type": "string", "minLength": 1},
        "year": {"type": "integer", "minimum": 1900, "maximum": 2100},
        "contributions": {
          "type": "array",
          "minItems": 1,
          "maxItems": 5,
          "items": {"$ref": "#/$defs/contribution"}
        },
        "doi_or_url": {"type": "string"}
      }
    },
    "sections": {
      "type": "array",
      "minItems": 4,
      "maxItems": 4,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["id", "title"],
        "properties": {
          "id": {"enum": ["background", "method", "results", "reflection"]},
          "title": {"type": "string", "minLength": 1}
        }
      }
    },
    "evidence": {
      "type": "array",
      "items": {"$ref": "#/$defs/evidence"}
    },
    "slides": {
      "type": "array",
      "minItems": 8,
      "items": {"$ref": "#/$defs/slide"}
    }
  },
  "$defs": {
    "speaker_notes_config": {
      "type": "object",
      "additionalProperties": false,
      "required": ["enabled", "generation_stage", "delivery_style", "target_minutes", "pace_units_per_minute"],
      "properties": {
        "enabled": {"type": "boolean"},
        "generation_stage": {"const": "post_qa"},
        "delivery_style": {"enum": ["verbatim"]},
        "target_minutes": {"type": "integer", "minimum": 5, "maximum": 120},
        "pace_units_per_minute": {"type": "integer", "minimum": 80, "maximum": 400}
      }
    },
    "evidence": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "claim", "kind", "confidence"],
      "properties": {
        "id": {"type": "string", "pattern": "^E[0-9]{3}$"},
        "claim": {"type": "string", "minLength": 1},
        "kind": {"enum": ["paper_claim", "presenter_analysis"]},
        "paper_page": {"type": "integer", "minimum": 1},
        "paper_section": {"type": "string"},
        "artifact_label": {"type": "string"},
        "quote_or_summary": {"type": "string"},
        "confidence": {"enum": ["high", "medium", "low"]}
      }
    },
    "run": {
      "type": "object",
      "additionalProperties": false,
      "required": ["text", "emphasis"],
      "properties": {
        "text": {"type": "string", "minLength": 1},
        "emphasis": {"enum": ["none", "bold", "accent"]}
      }
    },
    "body_point": {
      "type": "object",
      "additionalProperties": false,
      "required": ["runs"],
      "properties": {
        "runs": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/run"}},
        "evidence_ids": {
          "type": "array",
          "minItems": 0,
          "uniqueItems": true,
          "items": {"type": "string", "pattern": "^E[0-9]{3}$"}
        }
      }
    },
    "contribution": {
      "type": "object",
      "additionalProperties": false,
      "required": ["runs"],
      "properties": {
        "runs": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/run"}}
      }
    },
    "external_source": {
      "type": "object",
      "additionalProperties": false,
      "required": ["page_url", "license_name", "license_url", "retrieved_at"],
      "properties": {
        "provider": {"type": "string"},
        "creator": {"type": "string"},
        "page_url": {"type": "string", "pattern": "^https?://"},
        "asset_url": {"type": "string", "pattern": "^https?://"},
        "license_name": {"type": "string", "minLength": 1},
        "license_url": {"type": "string", "pattern": "^https?://"},
        "retrieved_at": {"type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},
        "sha256": {"type": "string", "pattern": "^[A-Fa-f0-9]{64}$"},
        "transformation": {"type": "string"}
      }
    },
    "visual": {
      "type": "object",
      "additionalProperties": false,
      "required": ["mode", "rationale", "alt_text", "qa_status"],
      "properties": {
        "mode": {"enum": ["paper_asset", "tikz", "data_redraw", "imagegen", "external_image", "none"]},
        "rationale": {"type": "string", "minLength": 1},
        "asset_ref": {"type": "string"},
        "data_spec_ref": {"type": "string"},
        "source_refs": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
        "caption": {"type": "string"},
        "alt_text": {"type": "string"},
        "expected_aspect_ratio": {"enum": ["wide", "standard", "tall", "not_applicable"]},
        "prompt": {"type": "string"},
        "search_query": {"type": "string"},
        "external_source": {"$ref": "#/$defs/external_source"},
        "no_text": {"type": "boolean"},
        "qa_status": {"enum": ["planned", "ready", "approved", "rejected"]}
      },
      "allOf": [
        {
          "if": {
            "properties": {"mode": {"const": "external_image"}},
            "required": ["mode"]
          },
          "then": {
            "required": ["asset_ref", "search_query", "external_source"]
          }
        }
      ]
    },
    "review": {
      "type": "object",
      "additionalProperties": false,
      "required": ["content_approved", "visual_approved"],
      "properties": {
        "content_approved": {"type": "boolean"},
        "visual_approved": {"type": "boolean"}
      }
    },
    "slide": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title"],
      "properties": {
        "id": {"type": "string", "pattern": "^S[0-9]{2}$"},
        "type": {"enum": ["cover", "paper_info", "one_page", "contents", "section_divider", "content", "closing"]},
        "section_id": {"enum": ["background", "method", "results", "reflection"]},
        "title": {"type": "string", "minLength": 1},
        "purpose": {"type": "string"},
        "takeaway": {"type": "string"},
        "layout": {"const": "content_stacked"},
        "body": {"type": "array", "minItems": 2, "maxItems": 5, "items": {"$ref": "#/$defs/body_point"}},
        "visual": {"$ref": "#/$defs/visual"},
        "speaker_notes": {"type": "string"},
        "speaker_seconds": {"type": "integer", "minimum": 5, "maximum": 600},
        "review": {"$ref": "#/$defs/review"}
      },
      "allOf": [
        {
          "if": {"properties": {"type": {"const": "content"}}, "required": ["type"]},
          "then": {"required": ["section_id", "purpose", "takeaway", "layout", "body", "visual", "review"]}
        },
        {
          "if": {"properties": {"type": {"const": "section_divider"}}, "required": ["type"]},
          "then": {"required": ["section_id"]}
        }
      ]
    }
  }
}
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall