Content
82%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.
The body is an exemplary lean, code-first reference: every subcommand has executable snippets with the non-obvious operational caveats (extras, API keys, store requirements) captured in terse comments. The only weaknesses are minor — later sections assume context from earlier ones, SHACLGenerator lacks a usage example, and there are no verification steps or deeper-reference pointers for the output-producing commands.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and code-first: each subcommand section is a one-line description plus a short snippet, with no explanation of concepts Claude already knows. Comments carry only non-obvious operational facts ("needs semantica[tripletstore-oxigraph]", "raises ProcessingError without one", "LLM-assisted (needs an llm-* extra + API key)") — every token earns its place, matching the 'Lean and efficient' anchor. | 5 / 5 |
Actionability | Each subcommand has concrete, executable Python with real imports, constructor arguments, and expected result attributes (e.g. "result.valid, result.errors, result.warnings"), meeting the 'mostly executable guidance' anchor. It falls short of 5 because later sections (export, align, evaluate) assume an `engine` and `onto` without restating instantiation, and `SHACLGenerator` is named with an import but no usage example. | 4 / 5 |
Workflow Clarity | The skill is a per-subcommand reference where each action is unambiguous and immediately executable, and the validate section surfaces result fields that serve as a check on ontology consistency. It is not a 5 because there are no explicit verification steps for output-producing operations (e.g. confirming an export file was written or handling `from_text` failures), and not a 3 because no section is vague about what to run. | 4 / 5 |
Progressive Disclosure | Sections are cleanly split per subcommand under a clear usage header and entry-point note, with no content that belongs in a separate file — no bundle files exist and each section is short, so nothing is inlined that should be external. It does not reach 5 because the body exceeds the ~50-line simple-skill threshold and offers no pointer to deeper API detail (e.g. a reference file for OntologyEngine's full method surface), leaving a minor organization gap. | 4 / 5 |
Total | 17 / 20 Passed |