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.
A well-executed delegation skill: executable commands throughout, risk-appropriate permission guidance (plan-mode pairing, bypass-immune checks, warnings on --skip-permissions), and a genuinely thoughtful conditional-routing workflow based on which sibling skills are loaded. The recursion guard is a smart touch. Weaknesses are minor: some duplicated framing text and a monolithic single-file structure that inlines the complete flag reference.
Suggestions
Trim the duplicated Otto-recursion guidance: the frontmatter already says "Do not load this skill if you are Otto", so the opening blockquote can be cut to one sentence pointing Otto away instead of re-explaining the reason.
Move the full flag tables (Session control, Mode selection, Permission modes, MCP/Extensions) into a references/ file (e.g., references/cli-reference.md) and keep only the highest-value flags inline in SKILL.md, since the skill itself names `astro otto --help` as the source of truth.
Add a short post-invocation validation note to Common delegation patterns: how to confirm the delegation succeeded (check exit status / `--mode json` final event) and what to do on failure (re-run with `-c`, or verify `astro otto version` first).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and decision-oriented — flag tables, bash blocks, and a routing table instead of prose explaining things Claude already knows. Minor trimmable spots keep it below the 5 anchor: the Otto-recursion warning is stated twice (frontmatter plus the "If you are Otto, stop here" blockquote restating it), and a few sections ("Cost and latency", "When delegating pays off") carry sentences that restate the same point twice. | 4 / 5 |
Actionability | Every section gives copy-paste-ready commands: `astro otto --mode text --permission-mode plan "audit this DAG"`, `--allowed-tools af,bash,read,grep`, `--output-schema @schema.json`, `astro otto --list-models`, and verification commands (`astro otto version`, `--help`, `update`). Tables map each flag to its behavior and when to use it, and the carve-out even supplies a verbatim script for offering Otto. | 5 / 5 |
Workflow Clarity | The delegation decision is clearly sequenced with checkpoints: scan loaded skills → route via the intent table → offer-first for AF2→3 with an explicit fallback ("If they decline, fall back to migrating-airflow-2-to-3") → verify availability (`astro otto version`, CLI v1.42+ guidance) → check the `af`-needs-connected-Airflow caveat. It misses the 5 anchor because there is no post-invocation validation step (how to check Otto's output succeeded or recover from a failed/expired session). | 4 / 5 |
Progressive Disclosure | No bundle files exist, so the skill is a single self-contained file; sections are well-organized with clear headers and a well-signaled "Authoritative references" list of one-level-deep external links. It stops short of 5 because the ~250-line body inlines the full flag reference (session control, mode, permission, extension tables) that could live in a references/ file — especially given the skill itself declares `astro otto --help` the source of truth — though for a delegation skill keeping key flags inline is defensible. | 4 / 5 |
Total | 17 / 20 Passed |