Content
90%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 unusually dense, high-signal maintenance skill: every section delivers project-specific facts, executable commands, and file-level pointers, with clear task-to-file workflows and verification steps. The main improvement space is structural — splitting the per-IDE compatibility and MCP-mode detail into reference files — and making a few verification steps more explicit about expected outcomes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every token carries repo-specific information Claude could not know (source map, test conventions, discovery timings, retry counters, per-IDE launch contracts) and it assumes competence ("MSTest + AwesomeAssertions", "ASP.NET Core server" with no tutorializing). There is no padded explanation of known concepts, matching the lean anchor 5 rather than anchor 4's 'minor instances that could be trimmed'. | 5 / 5 |
Actionability | Copy-paste-ready build/test commands, a maintenance section mapping each task to exact files ("handle in CliManager.cs ... add help in Program.cs ... add an integration test in run-devserver-cli-tests.ps1"), and concrete verification commands ("uno-devserver disco --json", "dotnet run from the Host dir"). Specific guidance covers the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | Multi-step tasks are clearly sequenced with verification checkpoints ("verify with uno-devserver disco --json in a real project", "test with --mcp-app + an MCP client", "EntryPointRegressionTests.cs guards the contract") and guardrails ("--addins MUST stay opt-in", "never rename ... constructor signatures"). It sits below anchor 5 because some checkpoints are implicit — e.g., "test via dotnet run" states no expected outcome and there is no error-recovery loop spelled out. | 4 / 5 |
Progressive Disclosure | The body is well organized into nine clearly headed sections with a References section listing repo docs, and there are no nested multi-level reference chains. However, no skill bundle files exist and sizable detail (per-IDE compatibility contracts in section 8, MCP roots modes and the ConnectionState lifecycle in section 6) is inlined in a ~9KB file where anchor 5 would expect that content split into well-signaled one-level-deep reference files. | 4 / 5 |
Total | 18 / 20 Passed |