Content
92%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.
An exemplary skill body: fully executable guidance covering the common paths, explicit validation and safe-defaults for batch operations, and clean one-level-deep progressive disclosure with verified reference and script files. The only slack is a small amount of trimmable boilerplate (citation section, release date, testing-provenance commentary).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and purposeful: routing tables, terse Core Operating Rules, a troubleshooting table, and lean code samples with no basic-concept padding. Not anchor 5 due to minor trimmable material: the boilerplate citation section (~15 lines), the "released September 21, 2026" date, and meta-commentary like "local fixtures and mocked request contracts were tested, without authenticated provider calls". | 4 / 5 |
Actionability | Every section gives copy-paste-ready, complete commands and code: uv venv/pip install lines with pinned versions, CLI invocations with flags, fully-imported Python examples including StreamInfo construction, and script calls with concrete flags (--recursive, --manifest, --create-index). Common cases (local file, stream, stdin bytes, batch, OCR) are all covered. | 5 / 5 |
Workflow Clarity | The path is clearly sequenced (choose route → install → verify → convert → check), with explicit validation checkpoints: installation verification via `markitdown --version` and `scripts/inspect_installation.py`, a numbered Quality Checks checklist for batch/output validation, safe-by-default batch behavior (skip unless --overwrite, opt-in --plugins/--allow-external-services), and a Troubleshooting table providing error-recovery feedback loops. | 5 / 5 |
Progressive Disclosure | SKILL.md is a true overview: a routing table, quick starts, and core rules, with all detail pushed to 7 reference files and 3 scripts that all exist on disk, indexed in a "Reference Files" table with explicit "Read when" triggers. References are one level deep with only sibling cross-links (e.g., file_formats.md → cloud_and_ocr.md), so navigation is easy and nothing is deeply nested. | 5 / 5 |
Total | 19 / 20 Passed |