oma-hwp

Convert HWP / HWPX / HWPML files to Markdown using kordoc. Extracts text, headings, tables, lists, images, footnotes, and hyperlinks. Use for Korean word processor files (Hangul), government documents, and AI-ready data preparation.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is actionable and well-sequenced with real commands and a clear validate-then-finalize workflow, but it is padded with decorative control-flow scaffolding and its referenced resource files are missing from the bundle. Tightening the meta-framework and adding the referenced files would materially improve it.

Suggestions

Remove the abstract control-flow scaffolding (Scenes/Transitions, 'SSL primitive' columns, Resource scope) and keep only the concrete commands, format table, and failure/recovery guidance to improve conciseness.

Create the referenced bundle files (resources/execution-protocol.md, resources/troubleshooting.md, resources/flatten-tables.ts, config/hwp-config.yaml) or drop the references so progressive disclosure points to real, navigable material.

Consolidate the redundant format/extension information spread across 'When to use', 'Expected inputs', and 'Supported Formats' into a single source of truth.

Dimension	Reasoning	Score
Conciseness	Mostly operational and useful, but carries unnecessary meta-scaffolding ('Scenes', 'SSL primitive' columns, 'Resource scope', 'Scheduling/Transitions' framing) that does not help Claude execute and could be tightened; not a monolithic concept explainer, so above score 1.	2 / 3
Actionability	Provides copy-paste-ready executable commands ('bunx kordoc@latest "{input_path}" -o "{output_path}"', the flatten-tables bun run, and a batch -d variant) with specific options, matching the fully-executable anchor.	3 / 3
Workflow Clarity	Clear sequence (PREPARE/ACQUIRE/ACT/VERIFY/FINALIZE) with an explicit VERIFY validation step and a failure/recovery feedback table, satisfying the validation-checkpoint anchor rather than the checkpoint-missing score-2 case.	3 / 3
Progressive Disclosure	Sections are well organized and references are signaled one level deep, but the referenced files (resources/execution-protocol.md, resources/troubleshooting.md, resources/flatten-tables.ts, config/hwp-config.yaml) do not exist in the bundle, so navigation is broken and the disclosure does not actually deliver.	2 / 3
	Total	10 / 12 Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A concise, third-person description that names concrete actions, covers natural trigger terms including Korean-language cues, and gives an explicit 'Use for' clause. It is clearly scoped to HWP-family files and unlikely to misfire.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('Convert HWP / HWPX / HWPML files to Markdown', 'Extracts text, headings, tables, lists, images, footnotes, and hyperlinks'), matching the multiple-specific-actions anchor rather than the single-domain score-2 example.	3 / 3
Completeness	Explicitly states what it does and when to use it via the 'Use for Korean word processor files (Hangul), government documents...' clause, satisfying both what AND when rather than capping at 2 for a missing trigger clause.	3 / 3
Trigger Term Quality	Natural user-facing terms are well covered (file extensions .hwp/.hwpx/.hwpml, 'Korean word processor files (Hangul)', 'government documents'); not merely technical jargon, so it exceeds the score-2 'some keywords' anchor.	3 / 3
Distinctiveness Conflict Risk	Targets a clear niche (Korean HWP-family files via kordoc) with distinct triggers unlikely to overlap with generic document/PDF skills; matches the clear-niche anchor.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: first-fluke/oh-my-agent
Path: .agents/skills/oma-hwp/SKILL.md
Commit: 3021301

Reviewed: about 21 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.