Content
78%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 tight, high-quality body: exact commands with documented outputs, an intent-mapped workflow, honest coverage limits (languages, staleness, unresolved dispatch), and prominent anti-patterns that prevent real misuse. Weaknesses are minor — placeholder-only examples without a worked sample, some duplicated guidance between sections, and error-recovery advice kept out of the workflow steps themselves.
Suggestions
Add one worked example in the cheat sheet with a real symbol and its actual output (e.g., `cat ~/.deeplake/memory/graph/find/pushSnapshot` and a sample of the numbered-handle output) so the command templates become fully copy-paste verifiable.
Deduplicate the rebuild/staleness guidance: state the auto-rebuild behavior and the mtime-vs-build-timestamp check once (either in the intro or in anti-patterns) instead of twice each.
Fold the key feedback loops into the Workflow steps themselves (e.g., step 2: "if find/ returns nothing, try multiple keywords"; step 5: "if the file's mtime is newer than the build, Read the live source") so checkpoints are embedded rather than deferred to a separate section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence — no explanation of concepts Claude already knows — but has minor repetition that could be trimmed: auto-rebuild is stated twice ("builds and refreshes automatically... You never run a build command" and the anti-pattern "Don't try to build it"), and staleness guidance appears in both "When NOT to use" ("If a file's mtime is newer than the build timestamp") and the anti-patterns ("The graph can be stale"). Above the 3-anchor because every section still carries unique information. | 4 / 5 |
Actionability | The path cheat sheet gives concrete copy-ready commands with exact mount paths and expected output ("cat ~/.deeplake/memory/graph/find/<pattern> ... Prints numbered handles [1] [2]"), and the workflow maps intent to specific commands. Not a 5 because all examples are templates with placeholders (<pattern>, <from>/<to>) — a single worked example with a real symbol and its actual output would close the gap. | 4 / 5 |
Workflow Clarity | The 5-step Workflow clearly sequences intent to action (broad → index.md, symbol → find/, relationships → show/, flow → path/, impact → impact/), and anti-patterns supply feedback loops ("Try multiple keywords if the first misses", stale build → "prefer the live source"). Below the 5-anchor because those checkpoints live in a separate section rather than being embedded as explicit validation steps in the workflow itself. | 4 / 5 |
Progressive Disclosure | A single self-contained file with clean, well-labeled sections (When to use / When NOT to use / cheat sheet / Workflow / Anti-patterns). No bundle files exist and none are needed — the skill itself acts as an index that progressively discloses to the mount's own index.md/query results, and nothing that belongs in a separate file is inlined. | 5 / 5 |
Total | 17 / 20 Passed |