Content
81%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 lean, highly executable guide: concrete CLI commands, an MCP config snippet, and explicit validation/error-recovery checkpoints across every scenario flow. The main gaps are modest — a version pin (0.1.16) that ages, setup detail that could be split into a reference file, and no concrete example MCP call for the primary read workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, opening with a one-line orientation ('ctxd synchronizes source content into ctxfs') and then command blocks with minimal preamble. Minor trimmable instances remain: the version pin 'The commands above match the published 0.1.16 package' (time-sensitive, not in a deprecated section) and asides like 'A client running elsewhere does not gain access to this machine's store from this configuration.' | 4 / 5 |
Actionability | Provides copy-paste-ready commands throughout ('pip install ctxd', 'ctxd backend set ctxfs', 'ctxd folders add /path/to/source --name Source', 'ctxd files grep "search text" --prefix Source --limit 20') plus a concrete MCP JSON config. It falls short of 5 because the most common path — MCP tool usage ('Begin with `tree` using an empty prefix, a small depth and a bounded limit') — is described in prose without a single concrete example call, and stays above 3 because everything given is executable rather than pseudocode. | 4 / 5 |
Workflow Clarity | Scenario-branched sequences are clearly ordered (connect → inspect → read; sync → re-read → confirm removal) with explicit validation and error-recovery checkpoints: 'inspect `ctxd backend status` and `ctxd folders list` before changing configuration', 'Read the same returned source path again after synchronization', 'If a source was removed, check the parent tree and confirm the old path is unavailable', 'Narrow a query when its result is incomplete', and 'If the installed CLI differs, inspect its help before changing configuration.' | 5 / 5 |
Progressive Disclosure | Four well-scoped sections with no nested references; external links (homepage, source repo) are one level deep and content is appropriately inline for a ~70-line single-purpose skill. Not 5 because the 'Set up ctxd when needed' section inlines install and MCP-client configuration detail that could live in a reference file, keeping SKILL.md closer to a pure overview; not 3 because nothing that clearly belongs in a separate file is inlined at length. | 4 / 5 |
Total | 17 / 20 Passed |