Content
85%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, well-structured single-call procedure with explicit validation, rollback, and grading — the body itself is close to exemplary. The main weakness is that the skill's core knowledge (the A–J pattern taxonomy, S1/S2 severities, self-verification checklist) lives in referenced files that are absent from the bundle and referenced via a non-resolving external path.
Suggestions
Ship the rulebook files inside the bundle and use skill-relative paths (e.g., `references/quick-rules.md` instead of `../../../skills/humanize-korean/references/quick-rules.md`) so steps 1 and 6 are actually executable.
Define the A–J category IDs and S1/S2/S3 severity scale inline (one line each, or a compact legend), since the grading thresholds ('S1 0건, S2 2건 이하') and the processing order depend on them.
Specify how `run_id` is generated and how 변경률 (change rate) is computed (e.g., character-level diff ratio), so the 30%/50% abort thresholds and the summary block can be produced deterministically.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~45-line body is lean and dense: 7 iron rules, 8 procedure steps, a grade table, options, and references — every token earns its place and nothing explains concepts Claude already knows. Firmly the score-5 anchor ('lean and efficient; assumes Claude's competence'). | 5 / 5 |
Actionability | Guidance is largely executable: concrete processing order ('D → A → I → G → H → F → B → C·J → E 순서로 문단 단위 처리'), numeric thresholds ('변경률 30% 초과 = 경고, 50% 초과 = 작업 중단·롤백'), and an exact output contract ('`_workspace/{run_id}/final.md`', 정확히 하나의 `<!-- HUMANIZE-SUMMARY -->` 블록). However the A–J category IDs and S1/S2/S3 severity scale that the thresholds and grades depend on are never defined in-body, and the rulebook that defines them ('quick-rules.md') does not exist at the referenced path — more than the score-5 'copy-paste ready, covers the common cases' bar. | 4 / 5 |
Workflow Clarity | The 8-step sequence is explicit with a validation checkpoint (step 6, quick-rules 자체검증 6항) and a feedback loop for error recovery ('위반 edit만 롤백해 최대 한 번 다시 처리한다'), plus abort/rollback thresholds at 50% change rate. This matches the score-5 anchor (clear sequence, explicit validation, retry loop) rather than score 4's 'minor validation gaps'. | 5 / 5 |
Progressive Disclosure | References are well-labeled and one level deep ('슬림 룰북', '분류 체계 본진', '윤문 처방'), but all three point to `../../../skills/humanize-korean/references/*.md` — a path outside this bundle — and no `references/` directory exists at all, so none of the referenced files resolve. Navigation is signaled but broken, fitting score 3 ('references present but not clearly/signally usable, organization could improve') rather than score 4's 'minor organization gaps'. | 3 / 5 |
Total | 17 / 20 Passed |