hwpx-mouseco

Generate HWPX report documents from structured report JSON while preserving template structure.

8|1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/mouseco/k-gov-skills --skill hwpx-mouseco
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: hwpx-mouseco
Source: https://github.com/mouseco/k-gov-skills/tree/main/skills/hwpx-mouseco
Command: npx skills add https://github.com/mouseco/k-gov-skills --skill hwpx-mouseco

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

๊ณต๊ณต๊ธฐ๊ด€ HWPX ๋ณด๊ณ ์„œ๋ฅผ ๋งŒ๋“ค ๋•Œ, ๋‹จ์ˆœ ์น˜ํ™˜์œผ๋กœ๋Š” ์–‘์‹์˜ ๋ฌธ๋‹จ ์œ„๊ณ„ยทํ‘œยท์Šคํƒ€์ผยท์—์…‹์„ ๋ง์น˜๊ธฐ ์‰ฌ์›Œ ์‚ฌ๋žŒ์ด ๋ฐ˜๋ณต ๊ฒ€ํ† ํ•˜๋А๋ผ ์‹œ๊ฐ„์ด ํฌ๊ฒŒ ์†Œ์š”๋œ๋‹ค.

Core Features & Use Cases

  • HWPX ๊ตฌ์กฐ ๋ณด์กด ๊ธฐ๋ฐ˜ ์ƒ์„ฑ: ํ…œํ”Œ๋ฆฟ์˜ ๋ฌธ๋‹จ ์œ„๊ณ„, ํ‘œ/์Šคํƒ€์ผ/์ฐธ์กฐ ๊ตฌ์กฐ๋ฅผ ์œ ์ง€ํ•œ ์ฑ„ report JSON์„ ๋ฐ˜์˜ํ•ด ์ตœ์ข… .hwpx๋ฅผ ์ƒ์„ฑํ•œ๋‹ค.
  • ํ”„๋กœํŒŒ์ผ(์›ํŽ˜์ดํผ/๋‹ค์ค‘ํŽ˜์ดํผ/์žฅ๋ฌธ) ์ง€์›: ๋ฐฐํฌ์šฉ ํ”„๋กœํŒŒ์ผ์— ๋งž์ถฐ ์ œ๋ชฉ/์ž‘์„ฑ์ •๋ณด/๋ชฉ์ฐจ/๋ณธ๋ฌธ ๋ฐ€๋„ ๋ฐ ์„œ์‹ ์ •์ฑ…์„ ์ ์šฉํ•œ๋‹ค.
  • XMLยทํŒจํ‚ค์ง€ ๋ฌด๊ฒฐ์„ฑ ๊ฒ€์ฆ: HWPX ZIP ๋ฐ ๋‚ด๋ถ€ XML ํŒŒ์‹ฑ, ์ฐธ์กฐ ์ •ํ•ฉ์„ฑ, ๋‚จ์€ ๋งˆ์ปค(** ๋“ฑ) ๋ฐ ๋ ˆ์ด์•„์›ƒ ์บ์‹œ(lineSegArray) ์ž”์กด ์—ฌ๋ถ€๋ฅผ ๊ฒ€์‚ฌํ•œ๋‹ค.
  • ํ‘œ(๋ฐ์ดํ„ฐ ํ‘œ) ์น˜ํ™˜ ์ •์ฑ…: ํ•„์š” ์‹œ โ€œclone_and_fillโ€ ๋ฐฉ์‹์œผ๋กœ ์กฐ๊ฑด์— ๋งž๋Š” ํ‘œ๋ฅผ ์ฐพ์•„ ์ฑ„์šฐ๋„๋ก ์„ค๊ณ„๋˜์–ด ์žˆ๋‹ค.

Quick Start

hwpx-mouseco ์Šคํ‚ฌ๋กœ templates/๋ถ™์ž„1 ๋ณด๊ณ ์„œ ์–‘์‹_๋ฐฐํฌ์šฉ_์›ํŽ˜์ดํผ.hwpx ํ…œํ”Œ๋ฆฟ์— examples/public_ai_adoption_report.json ๋‚ด์šฉ์„ ๋„ฃ์–ด output/report.hwpx ๊ฒฐ๊ณผ๋ฅผ ์ƒ์„ฑํ•ด ์ฃผ์„ธ์š”.

Frequently Asked Questions about hwpx-mouseco

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate HWPX public institution reports without breaking the template structure?โ–ผ

To generate HWPX public institution reports without breaking template structure, this Skill preserves paragraph hierarchy, styles, tables, and packaging integrity while injecting report JSON content into the final .hwpx file.

What is the best way to fill tables in HWPX documents using JSON data?โ–ผ

Filling tables in HWPX documents using JSON data is handled through a clone_and_fill policy, which locates target tables within the template and populates them with structured data while maintaining XML reference consistency.

Can I use different layout profiles like onepager and longform for HWPX report generation?โ–ผ

You can use different layout profiles for HWPX report generation, including onepager, multipage, and longform distributions, each applying specific heading, metadata, and body density formatting policies.

Why does my HWPX file get corrupted after replacing text in the XML?โ–ผ

HWPX file corruption after XML text replacement often occurs because required BinData assets and manifest references are lost; this Skill validates ZIP packaging and internal XML parsing to prevent structural damage.

How do I remove leftover markdown emphasis markers from generated HWPX documents?โ–ผ

Removing leftover markdown emphasis markers from generated HWPX documents is performed automatically during compilation, checking for stray syntax and layout cache remnants to ensure clean public document output.

Does HWPX report generation require manual review of paragraph hierarchy and styles?โ–ผ

HWPX report generation eliminates manual review of paragraph hierarchy and styles by preserving the template's original formatting structure and running reference consistency validation before finalizing the document.