Content
77%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 a well-engineered orchestrator: an exceptionally clear 11-phase workflow with three provider-specific paths, explicit validation and retry loops, and concrete execution directives. Its weaknesses are repeated enforcement of the same phase-skip prohibitions and a critical bundle defect — all 11 linked phase files are missing, breaking the progressive-disclosure chain the entire skill depends on.
Suggestions
Include the 11 phaseN-*.md files in the skill bundle (or fix the links to their actual location) — the phase table and execution model reference them as the source of truth for every step, and none of them resolve in the current bundle.
Consolidate the phase-skip prohibition: the 'Never do this' list, the 'All 11 phases are mandatory' paragraph, and the intro line all restate the same rule; stating it once prominently would trim tokens without losing clarity.
Add one concrete MCP tool invocation example (or a pointer to one in api-reference.md) in the API Access section so the 'use MCP tools, not raw API calls' directive is executable even before a phase file is opened.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Quotes: "one phase at a time, in order. Do not plan ahead, do not batch phases, do not jump"; "Skip phases for non-auto-import providers (e.g. 'phases 7–10 not needed' for LiveKit) — for these providers every phase is mandatory"; "All 11 phases are mandatory for non-auto-import providers — execute every phase, every time, no exceptions." The body is dense, tabular, and free of explanations of concepts Claude already knows, but the prohibition on skipping phases is restated three or more times across the Execution Model section, and the Never-do list overlaps itself (items about 'seems done', the LiveKit example, and the blanket mandate). Matches the 4 anchor (efficient with minor repetition that could be trimmed); not 5 because the redundant re-enforcement costs tokens without adding information. | 4 / 5 |
Actionability | Quotes: "Announce the phase you are starting: 'Starting Phase N — [name]'"; "All Cekura API calls use `X-CEKURA-API-KEY: <key>` as the auth header"; "run `/setup-mcp` to configure the connection"; a concrete confirmation example ("I'll set language to `multi` — the system prompt contains Hindi-specific instructions..."). For an instruction-only orchestrator the guidance is specific and executable per the scoring notes. Not 5 because the per-phase executable steps live in the linked phaseN-*.md files, which are absent from the bundle, leaving minor gaps in what can actually be executed from the provided files. | 4 / 5 |
Workflow Clarity | Quotes: the three path diagrams ("Phase 1 → Phase 2 → ... → Phase 11" for standard, LiveKit/Pipecat, and auto-import); the 11-phase table with per-path skip/require flags; "The skill does not end until Phase 11's verification run succeeds. If the run reveals issues ... go back to the relevant phase, fix the issue, and retry the run"; "If the user has partially completed setup: ask at the start which phases are done ... but always end at Phase 11." This is a clear sequence with an explicit validation phase, a verify→fix→retry feedback loop, gate conditions per phase, and defined resume behavior — matching the 5 anchor. | 5 / 5 |
Progressive Disclosure | Quotes: "[phase1-project.md](phase1-project.md)" through "[phase11-verify.md](phase11-verify.md)" in the phase table, plus the Reference Files section ("references/integrations.md — Full per-provider field lists...", "scripts/upload-agent.sh — Curl wrapper..."). The structure is well designed — a lean overview, one-level-deep references, each with a one-line description — and all six references/ files and the script exist in the bundle. However, scored against the actual bundle, none of the 11 phaseN-*.md files referenced by the core execution model exist on disk, so the primary navigation targets are broken. This is more than the 'minor organization gaps' of the 4 anchor; it sits between anchors 3 and 4 and lands at 3 because the skill's main workflow cannot navigate to its own step files. | 3 / 5 |
Total | 16 / 20 Passed |