Content
70%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured orchestration skill with excellent workflow clarity, clear state management, and concrete script invocations. Its main weaknesses are verbosity (the document is quite long with several large tables that could be more compact) and the lack of verifiable bundle files to support its references to external scripts and documentation. The actionability is strong with specific commands and field sets, though some flows delegate to unverifiable external files.
Suggestions
Consider moving the configuration defaults table, anti-patterns table, and user instruction examples into separate reference files to reduce the main skill's token footprint and improve progressive disclosure.
Ensure bundle files (scripts/ci-poll-decide.mjs, scripts/ci-state-update.mjs, references/fix-flows.md) are included so the skill's references are verifiable and the progressive disclosure structure is complete.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is quite long (~300+ lines) and includes several tables and sections that could be tightened. Some content like the anti-patterns table, user instruction examples, and session context behavior add useful but somewhat verbose context. The configuration defaults table and detailed state tracking variables are necessary but could be more compact. It doesn't over-explain basic concepts, but the overall volume is high for what could be more concisely expressed. | 3 / 5 |
Actionability | The skill provides concrete commands (bash invocations of decision scripts, specific MCP tool calls, git commands), specific field sets for polling, and clear state variable management. However, some actions reference external files (e.g., 'references/fix-flows.md') without providing their content, and the subagent spawning mechanism is described conceptually rather than with fully executable examples. The script invocations are concrete and copy-paste ready. | 4 / 5 |
Workflow Clarity | The workflow is exceptionally well-sequenced with clear steps (Initialize → Poll → Decide → Handle → Track), explicit validation checkpoints (gate checks before local fixes, cycle classification before handling codes), feedback loops (poll → decide → act → wait for new CI Attempt → poll again), and error recovery paths. The ci-state-update.mjs gate check prevents wasted budget, and the circuit breaker prevents infinite polling. Destructive operations have explicit safety rules (e.g., no 'git add -A'). | 5 / 5 |
Progressive Disclosure | The skill references 'references/fix-flows.md' for detailed fix flows and mentions bundle scripts (ci-poll-decide.mjs, ci-state-update.mjs), but no bundle files were provided to verify these exist. The SKILL.md itself is quite long and inlines a lot of content (status tables, error handling, configuration) that could potentially be split into reference files. The structure within the file is good with clear sections, but the overall length suggests some content should be disclosed progressively via separate files. | 3 / 5 |
Total | 15 / 20 Passed |