Kordoc parse metadata

Skill composite/korean-skills/skills/kordoc-parse-metadata

동해물과 백두산이 마르고 닳도록 대한민국 사정에 맞게 구성된 에이전트 스킬 모음.

Install

npx -y skills add composite/korean-skills --skill kordoc-parse-metadata

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when extracting document metadata with `npx` and kordoc instead of reading the full document text. Trigger for requests about title, author, created date, or quick inspection of local HWP, HWPX, and PDF files through `kordoc:parse_metadata`.

SKILL.md

2.3 KB, as published. Nobody here has run it

kordoc: parse_metadata

src/mcp.ts uses internal metadata-only helpers, but the public npx kordoc surface does not expose that fast path. With npx only, emulate the tool by parsing JSON and returning just the metadata fields.

Input Requirements

Require exactly one target document.
Require the user to attach the document or provide a concrete local path.
Accept only supported formats: .hwp, .hwpx, .pdf.
Do not proceed if the document is missing or the path is ambiguous.

Command

npm exec --yes --package=kordoc --package=pdfjs-dist -- node <<'SCRIPT'
const p = require("path"), fs = require("fs");
const nmBin = process.env.PATH.split(p.delimiter).find(d => d.endsWith(".bin"));
const kUrl = "file:///" + p.join(p.resolve(nmBin, ".."), "kordoc", "dist", "index.js").split(p.sep).join("/");
import(kUrl).then(async (k) => {
  const filePath = "/abs/path/document.hwpx";
  const raw = fs.readFileSync(filePath);
  const buffer = raw.buffer.slice(raw.byteOffset, raw.byteOffset + raw.byteLength);
  const result = await k.parse(buffer);
  if (!result.success) throw new Error(result.error);
  console.log(JSON.stringify({
    fileType: result.fileType ?? null,
    pageCount: result.pageCount ?? null,
    metadata: result.metadata ?? null,
    outline: result.outline ?? null,
    warnings: result.warnings ?? null
  }, null, 2));
}).catch(e => { console.error(e); process.exit(1); });
SCRIPT

Workflow

Resolve the target file to an absolute path.
Parse the file using the library API.
Return only metadata-oriented fields.
Say clearly that this path performs a full parse because metadata-only internals are not exposed through the public CLI.

Guardrails

Keep the answer focused on metadata.
Do not invent missing fields.
If the user truly needs the fastest possible metadata-only path, note that the source tree has a private implementation but this skill is intentionally npx-only.
Refuse to continue when no supported document was provided.