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

78%

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

Fix and improve this skill with Tessl

tessl review fix ./benchmarks/runs/oma/.agents/skills/oma-hwp/SKILL.md

Quality

Content

63%Weight 40%Scale 1-5

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

The body is well-structured with concrete commands, a clear scene-based workflow, and validation/recovery guidance, but it carries redundant control-flow restatements and references bundle files that are absent from the workspace. Tightening the overlapping structural sections and aligning references with the actual bundle would raise quality.

Suggestions

Collapse the overlapping 'Control-flow features', 'Scenes', 'Transitions', and 'Actions' sections into a single workflow description to remove redundant control-flow restatements.

Ensure the referenced bundle files (`resources/execution-protocol.md`, `resources/troubleshooting.md`, `config/hwp-config.yaml`) actually ship alongside SKILL.md, or remove the references.

Soften the hardcoded path in the flatten-tables command (`.agents/skills/oma-hwp/resources/flatten-tables.ts`) to a portable relative path so the example works in arbitrary install locations.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with tables and command blocks, but control flow is restated across 'Control-flow features', 'Scenes', 'Transitions', and 'Actions', and self-evident scaffolding ('Resource scope', 'Preconditions', 'Effects and side effects') adds padding that could be trimmed.	3 / 5
Actionability	Concrete, mostly copy-paste-ready commands (`bunx kordoc@latest "{input_path}" -o "{output_path}"` and the batch `-d` variant) cover common cases, with a minor gap in the hardcoded flatten-tables path that may not match a caller's environment.	4 / 5
Workflow Clarity	Clear Entry → Scenes (PREPARE/ACQUIRE/ACT/VERIFY/FINALIZE) → Transitions → Failure/recovery → Exit sequence with a VERIFY checkpoint and feedback table, though the recovery loops live in a separate table rather than inline retry guidance.	4 / 5
Progressive Disclosure	References are clearly signaled and one level deep in a References section, but the referenced bundle files (`resources/execution-protocol.md`, `resources/troubleshooting.md`, `config/hwp-config.yaml`) are not present in the workspace, so the actual bundle structure does not match the references.	3 / 5
	Total	14 / 20 Passed

Description

92%Weight 40%Scale 1-5

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

The description is specific, complete, and well-targeted, clearly stating both capabilities and use contexts with strong trigger terms and minimal conflict risk. The only minor gap is that a few casual user phrases live in the body rather than the description itself.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('Convert HWP / HWPX / HWPML files to Markdown', 'Extracts text, headings, tables, lists, images, footnotes, and hyperlinks') with comprehensive coverage of extraction targets.	5 / 5
Completeness	Explicitly answers both what ('Convert... Extracts...') and when ('Use for Korean word processor files (Hangul), government documents, and AI-ready data preparation').	5 / 5
Trigger Term Quality	Strong keyword coverage with file extensions and synonyms (HWP/HWPX/HWPML, Hangul, Korean word processor files), but a few casual user phrases like '한글 파일' or 'convert this HWP' appear only in the body, not the description.	4 / 5
Distinctiveness Conflict Risk	Clear niche (Korean HWP-family files via kordoc) with specific extensions and Hangul framing, giving minimal overlap with other skills.	5 / 5
	Total	19 / 20 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: benchmarks/runs/oma/.agents/skills/oma-hwp/SKILL.md
Commit: 032c988

Reviewed: 2 days 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.