Content
96%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 strong, dense, highly actionable skill body: every command is executable with real flag values, the investigation workflow is explicitly sequenced with error-recovery guidance for empty/unprofiled results, and there is essentially no token waste on concepts Claude already knows. The only structural weakness is that all reference detail (output schemas, flag grammar) is inlined in one ~120-line file rather than split into a references file under a leaner overview.
Suggestions
Move the field-by-field output schema in "Reading the Output" (tree node fields, omitted_subtrees, warnings, units) into a references/output-fields.md and keep a 2-3 line summary in SKILL.md, so the overview stays lean and detail is one level deep.
Consider relocating the flag-grammar details (the repeatable `--filter` forms and `--start`/`--end` time-expression syntax) to a references/cli-reference.md, keeping the command table and the workflow with inline examples in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body contains almost exclusively tool-specific information Claude could not know: the command table with flags and defaults ("--limit (default 20, max 100)", "--min-node-ratio (default 0.01)"), the `--filter` grammar ("key=v1,v2", "key:exists"), time-expression syntax, output-field semantics, and performance guidance ("flame-graph can take ~40 s"). There is no explanation of what profiling or flame graphs are in general; the closest to over-explanation is the "Self vs total" bullet, but it is anchored to interpreting this tool's output fields. It is not 4: there is no padded or generic section to trim — every line delivers novel CLI or output information. | 5 / 5 |
Actionability | Every workflow step is a copy-paste-ready command with real flag values: "cx profiling services --category cpu --limit 10 -o json", "cx profiling metrics <service> --profile-type cpu --sum-by pod --limit 5 -o json", "cx profiling flame-graph <service> --profile-type cpu --filter k8s.pod.name=<pod> --min-node-ratio 0.05 --max-depth 20 -o json", including jq post-processing ("| jq '.top_functions'"). The command table, flag reference, and worked examples cover the common cases end to end. It is not 4: no gaps — commands are fully executable, not hints or pseudocode. | 5 / 5 |
Workflow Clarity | The "Investigation Workflow" is a clear 5-step sequence ordered cheap-to-expensive ("Rank first, drill down second — `services` and `metrics` are cheap; `flame-graph` is the expensive call"), with skip conditions ("skip if the user named one") and step chaining ("split by `pod` or a label key from step 3"). Error-recovery feedback loops are explicit: "Empty results are not errors — ... re-check `metadata` and widen `--start`" and "No profiling data — ... answer from `cx-service-catalog` or `cx-telemetry-querying` ... and say that function-level detail needs profiling enabled". All commands are read-only, so the destructive/batch validation cap does not apply. It is not 4: recovery guidance for the realistic failure modes (empty results, unprofiled service, partial-range warnings) is stated explicitly rather than left implicit. | 5 / 5 |
Progressive Disclosure | The single-file body is well structured with clear sections (CLI Commands, Investigation Workflow, Reading the Output, Key Principles, Related Skills) and no nested or dead references (no references/, scripts/, or assets/ directories exist). However, at ~120 lines it inlines reference-grade material — the full "Reading the Output" field-by-field schema (tree node fields, omitted_subtrees, warnings) and detailed flag semantics — that could live in a one-level-deep references file, keeping SKILL.md a leaner overview. It is not 3: the structure is clear and nothing is buried or unorganized. It is not 5: the score-5 anchor expects content appropriately split across well-signaled separate files; this is a moderately long monolith. | 4 / 5 |
Total | 19 / 20 Passed |