Materials Package
This is an OMH materials-package workflow skill, projected for Agent Skills hosts (Claude Code, Codex, Cursor, opencode, OpenClaw, pi).
Why This Exists
materials-package exists so Hermes can handle document, deck, spreadsheet, PDF, Word, Keynote, HWP, and Markdown work as a first-class material-processing workflow without becoming a hidden file generator.
Do Not Use When
- The user only needs a weekly/monthly report outline; use
omh-report-package.
- The user asks for recurring meeting minutes or scrum history; use
omh-operating-rhythm.
- The request is code documentation, README, or project wiki maintenance; use
omh-wiki.
Examples
Good example:
- Prompt: materials-package 엑셀 매출 리포트를 PDF로 공유할 수 있게 준비해줘.
- Expected behavior: Create a material plan with xlsx/pdf target formats, source inputs, missing metrics, QA checks, and a generation handoff boundary.
- Why: The request is about material processing and binary export evidence, not just a text report outline.
Bad example:
- Prompt: materials-package prove the PDF was sent to leadership.
- Expected behavior: Ask for observed delivery evidence or record the delivery as not_observed instead of claiming it happened.
- Why: A prepared material artifact cannot prove export, approval, or delivery.
Completion Checklist
- The material source, target format, audience, structure, and QA expectation are named.
- Binary export, rendering, formula recalculation, attachment, and delivery stay observed-only.
- The next action identifies whether the package is planned, generated, QA-ready, or blocked.
Recovery Notes
- If source metrics needed by an outline section are missing, retain the verified source facts and outline, mark that section unresolved, and hand back material_artifact/v1 with its missing inputs and output owner.
- If xlsx_recalc.py reports recalculated false, retain the observed sheet_schema, mark formula_recalculation not_observed, and hand back its missing tools and the --out recalculation and cached-value read-back steps.
- If DOCX package validation passes without a rendered converted PDF, retain observed section_structure and required_clause_check, mark appearance and page_count not_observed, and hand back the converted-PDF preview checks.
When to Use
Use when Hermes should turn source inputs into a material plan for decks, PDFs, Word/documents, spreadsheets, HWP, Markdown, office-file summaries, comparisons, table extraction plans, or binary export handoff without claiming file generation.
Strong routing signals: `materials-package`, `material package`, `materials package`, `document package`, `deck file`, `binary export`, `file export`, `render qa`, `layout qa`, `ppt and pdf`, `pdf and ppt`, `ppt/pdf`, `pdf/ppt`, `spreadsheet to pdf`, `excel to pdf`, `monthly report pdf`, `attached spreadsheet`, `word document`, `word doc`, `document action items`, `compare pdfs`, `pdf differences`, `extract tables from pdf`, `pdf to csv`, `spreadsheet analysis brief`, `clean analysis brief`, `pdf`, `pptx`, `keynote`, `keynote deck`, `docx`, `xlsx`, `csv report`, `spreadsheet`, `excel`, `hwp`, `korean hwp`, `proposal document`, `PDF`, `HWP`, `첨부한 엑셀`, `첨부한 워드`, `워드 문서`, `PDF 두 개 비교`, `PDF 표를 CSV`, `PDF 표 추출`, `분석 브리프`, `엑셀을 월간 보고서`, `자료 패키지`, `자료 처리`, `자료 생성`, `문서 패키지`, `문서 생성`, `제안서 문서`, `엑셀`, `스프레드시트`, `피디에프`, `한글 문서`, `키노트`, `파일 export`, `파일 생성`, `렌더 QA`, `PDF랑 PPT`, `PPT랑 PDF`, `PDF와 PPT`, `PPT와 PDF`, `PDF랑 PPT로`
Catalog Metadata
Category: materials
Phase: material-plan
Quality tier: material-gated
Reasoning demand: standard
Quality bar:
- Name audience, source inputs, requested extraction/comparison task, target formats, outline sections, assumptions, missing inputs, and output owner.
- Attach format-specific QA expectations before preparing a binary-generation handoff.
- Record binary export, render QA, formula checks, approvals, and delivery only from observed evidence.
- On Hermes, a rung taken from a bundled document skill is observed only from that skill's result for that exact file, judged by its field, not its exit code:
"rendered": false or "recalculated": false exits 0 yet leaves that rung not observed, blocked on the missing tools it names; other observed evidence for a rung still counts.
- On Hermes, the bundled document skills give these rungs when available (
powerpoint, xlsx, docx; microsoft-office from v0.22.6; same scripts): PowerPoint gives slide_count (pptx_read.py --outline) and render_screenshot (pptx_render.py into a fresh directory, its image count matching slide_count, since it lists every image already in that directory); pdf gives page_count (pdf_read.py --meta) and render_preview (pdf_page_image.py); Excel gives sheet_schema (xlsx_read.py --sheets) and formula_recalculation (xlsx_recalc.py --out <copy>, since without --out it replaces the input and rungs or approvals already recorded were for other bytes, then the cached results read back with xlsx_read.py --formulas, where an error value or a formula with no cached value is a finding); Word gives section_structure and required_clause_check (docx_read.py --structure and --text) but no page_count or appearance until a converted PDF is rendered, and docx_validate.py checks package health, never rendering. Images that exist are not a render pass until each one has been inspected, and a producer's "ok": true is never the QA verdict.
- No bundled reader covers HWP or Keynote: ask which tool the session has (Hancom Office or a converter for HWP, Keynote export for Keynote). With none, the plan ends at the outline, every QA rung for that file is not_observed, and a PDF export reviewed with the
pdf rungs is the checkable substitute; say the layout of the HWP or Keynote file itself was not checked.
Required inputs:
- audience or recipient
- source inputs
- target format(s)
- deadline or delivery context
- missing data or assumptions
Expected outputs:
- material_artifact/v1 plan
- format-specific QA ladder
- executor-neutral generation handoff when needed
- observed export boundary
Artifact expectations:
- material_artifact/v1 under .omh/materials when a wrapper or CLI records it
Safety rules:
- Do not claim PPTX, PDF, Keynote, DOCX, XLSX, HWP, or upload output without observed file evidence.
- Do not claim render QA, formula recalculation, approval, or delivery from a prepared material plan.
- Keep source facts, assumptions, missing inputs, and generated output evidence separate.
Runtime Evidence
Use the current host's own tools and subagent/task mechanism when available;
otherwise run the same lanes sequentially or name the unavailable capability.
A prepared plan, handoff, checklist, or skill installation is not execution,
review, CI, merge-readiness, or merge evidence. Record actual tool results, or
not_observed / not_available, in the record; never invent dispatch or host
accounting.
Treat supplied context as advisory, not proof of hidden memory reads or writes.
State scope, constraints, verification, and the stop condition before work.
Reply in the user's own words and the host's own voice: the host's persona owns
reply language, tone, speech level, and sentence endings, progress updates
included (where it sets no language, use the one the user wrote in), and OMH
shapes structure and content only; OMH's record terms
(surface, lane, wrapper, handoff, evidence boundary, not_observed) stay in
records and tool calls, never in the sentence the user reads unless they ask
about one; and when a real unresolved user decision or a useful briefing discussion
remains, offer one specific, content-linked question. Completed work needs no question;
omit unrelated non-action footers and generic offers to continue.
Supporting paths are relative to this skill directory; sibling skill paths are
relative to its parent. Resolve them from the host-provided skill base directory
({baseDir} on hosts that provide it), never a hardcoded install location.
A named workflow not installed here is unavailable, not permission to emulate
its host-specific capabilities. Verify through the real surface before done.
1---2name: omh-materials-package-23description: "[omh] PPT, PDF, Excel, or HWP output to produce: decks, PDFs, spreadsheets, documents, HWP, Markdown, and binary export handoffs. Use when the user says: materials-package, material package, materials package, document package, deck file, binary export, file export, render qa."4license: MIT5metadata:6 source: https://skillmd.com/skills/rlaope/omh-materials-package-27 hermes:8 tags: [workflow, oh-my-hermes, materials]9 category: materials10 phase: material-plan11 role: operator12 quality_tier: material-gated13---1415# Materials Package1617This is an OMH `materials-package` workflow skill, projected for Agent Skills hosts (Claude Code, Codex, Cursor, opencode, OpenClaw, pi).1819## Why This Exists2021`materials-package` exists so Hermes can handle document, deck, spreadsheet, PDF, Word, Keynote, HWP, and Markdown work as a first-class material-processing workflow without becoming a hidden file generator.2223## Do Not Use When2425- The user only needs a weekly/monthly report outline; use `omh-report-package`.26- The user asks for recurring meeting minutes or scrum history; use `omh-operating-rhythm`.27- The request is code documentation, README, or project wiki maintenance; use `omh-wiki`.2829## Examples3031Good example:3233- Prompt: materials-package 엑셀 매출 리포트를 PDF로 공유할 수 있게 준비해줘.34- Expected behavior: Create a material plan with xlsx/pdf target formats, source inputs, missing metrics, QA checks, and a generation handoff boundary.35- Why: The request is about material processing and binary export evidence, not just a text report outline.3637Bad example:3839- Prompt: materials-package prove the PDF was sent to leadership.40- Expected behavior: Ask for observed delivery evidence or record the delivery as not_observed instead of claiming it happened.41- Why: A prepared material artifact cannot prove export, approval, or delivery.4243## Completion Checklist4445- The material source, target format, audience, structure, and QA expectation are named.46- Binary export, rendering, formula recalculation, attachment, and delivery stay observed-only.47- The next action identifies whether the package is planned, generated, QA-ready, or blocked.4849## Recovery Notes5051- If source metrics needed by an outline section are missing, retain the verified source facts and outline, mark that section unresolved, and hand back material_artifact/v1 with its missing inputs and output owner.52- If xlsx_recalc.py reports recalculated false, retain the observed sheet_schema, mark formula_recalculation not_observed, and hand back its missing tools and the --out <copy> recalculation and cached-value read-back steps.53- If DOCX package validation passes without a rendered converted PDF, retain observed section_structure and required_clause_check, mark appearance and page_count not_observed, and hand back the converted-PDF preview checks.54555657## When to Use5859Use when Hermes should turn source inputs into a material plan for decks, PDFs, Word/documents, spreadsheets, HWP, Markdown, office-file summaries, comparisons, table extraction plans, or binary export handoff without claiming file generation.6061 Strong routing signals: `materials-package`, `material package`, `materials package`, `document package`, `deck file`, `binary export`, `file export`, `render qa`, `layout qa`, `ppt and pdf`, `pdf and ppt`, `ppt/pdf`, `pdf/ppt`, `spreadsheet to pdf`, `excel to pdf`, `monthly report pdf`, `attached spreadsheet`, `word document`, `word doc`, `document action items`, `compare pdfs`, `pdf differences`, `extract tables from pdf`, `pdf to csv`, `spreadsheet analysis brief`, `clean analysis brief`, `pdf`, `pptx`, `keynote`, `keynote deck`, `docx`, `xlsx`, `csv report`, `spreadsheet`, `excel`, `hwp`, `korean hwp`, `proposal document`, `PDF`, `HWP`, `첨부한 엑셀`, `첨부한 워드`, `워드 문서`, `PDF 두 개 비교`, `PDF 표를 CSV`, `PDF 표 추출`, `분석 브리프`, `엑셀을 월간 보고서`, `자료 패키지`, `자료 처리`, `자료 생성`, `문서 패키지`, `문서 생성`, `제안서 문서`, `엑셀`, `스프레드시트`, `피디에프`, `한글 문서`, `키노트`, `파일 export`, `파일 생성`, `렌더 QA`, `PDF랑 PPT`, `PPT랑 PDF`, `PDF와 PPT`, `PPT와 PDF`, `PDF랑 PPT로`6263## Catalog Metadata6465Category: `materials`66Phase: `material-plan`67Quality tier: `material-gated`68Reasoning demand: `standard`6970Quality bar:7172- Name audience, source inputs, requested extraction/comparison task, target formats, outline sections, assumptions, missing inputs, and output owner.73- Attach format-specific QA expectations before preparing a binary-generation handoff.74- Record binary export, render QA, formula checks, approvals, and delivery only from observed evidence.75- On Hermes, a rung taken from a bundled document skill is observed only from that skill's result for that exact file, judged by its field, not its exit code: `"rendered": false` or `"recalculated": false` exits 0 yet leaves that rung not observed, blocked on the missing tools it names; other observed evidence for a rung still counts.76- On Hermes, the bundled document skills give these rungs when available (`powerpoint`, `xlsx`, `docx`; `microsoft-office` from v0.22.6; same scripts): PowerPoint gives `slide_count` (`pptx_read.py --outline`) and `render_screenshot` (`pptx_render.py` into a fresh directory, its image count matching `slide_count`, since it lists every image already in that directory); `pdf` gives `page_count` (`pdf_read.py --meta`) and `render_preview` (`pdf_page_image.py`); Excel gives `sheet_schema` (`xlsx_read.py --sheets`) and `formula_recalculation` (`xlsx_recalc.py --out <copy>`, since without `--out` it replaces the input and rungs or approvals already recorded were for other bytes, then the cached results read back with `xlsx_read.py --formulas`, where an error value or a formula with no cached value is a finding); Word gives `section_structure` and `required_clause_check` (`docx_read.py --structure` and `--text`) but no `page_count` or appearance until a converted PDF is rendered, and `docx_validate.py` checks package health, never rendering. Images that exist are not a render pass until each one has been inspected, and a producer's `"ok": true` is never the QA verdict.77- No bundled reader covers HWP or Keynote: ask which tool the session has (Hancom Office or a converter for HWP, Keynote export for Keynote). With none, the plan ends at the outline, every QA rung for that file is not_observed, and a PDF export reviewed with the `pdf` rungs is the checkable substitute; say the layout of the HWP or Keynote file itself was not checked.7879Required inputs:8081- audience or recipient82- source inputs83- target format(s)84- deadline or delivery context85- missing data or assumptions8687Expected outputs:8889- material_artifact/v1 plan90- format-specific QA ladder91- executor-neutral generation handoff when needed92- observed export boundary9394Artifact expectations:9596- material_artifact/v1 under .omh/materials when a wrapper or CLI records it9798Safety rules:99100- Do not claim PPTX, PDF, Keynote, DOCX, XLSX, HWP, or upload output without observed file evidence.101- Do not claim render QA, formula recalculation, approval, or delivery from a prepared material plan.102- Keep source facts, assumptions, missing inputs, and generated output evidence separate.103104## Runtime Evidence105106Use the current host's own tools and subagent/task mechanism when available;107otherwise run the same lanes sequentially or name the unavailable capability.108A prepared plan, handoff, checklist, or skill installation is not execution,109review, CI, merge-readiness, or merge evidence. Record actual tool results, or110`not_observed` / `not_available`, in the record; never invent dispatch or host111accounting.112Treat supplied context as advisory, not proof of hidden memory reads or writes.113State scope, constraints, verification, and the stop condition before work.114Reply in the user's own words and the host's own voice: the host's persona owns115reply language, tone, speech level, and sentence endings, progress updates116included (where it sets no language, use the one the user wrote in), and OMH117shapes structure and content only; OMH's record terms118(surface, lane, wrapper, handoff, evidence boundary, not_observed) stay in119records and tool calls, never in the sentence the user reads unless they ask120about one; and when a real unresolved user decision or a useful briefing discussion121remains, offer one specific, content-linked question. Completed work needs no question;122omit unrelated non-action footers and generic offers to continue.123Supporting paths are relative to this skill directory; sibling skill paths are124relative to its parent. Resolve them from the host-provided skill base directory125(`{baseDir}` on hosts that provide it), never a hardcoded install location.126A named workflow not installed here is unavailable, not permission to emulate127its host-specific capabilities. Verify through the real surface before done.