CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cx-profiling

Query Coralogix continuous-profiling data with the `cx profiling` CLI — find which services use the most CPU or memory, which profile types a service has, what profiles can be filtered by, when usage spiked and which pod or version caused it, and which code paths and functions a service spends its CPU or memory on (flame graphs). Use when the user asks "which services use the most CPU", "top memory consumers", "what is service X spending CPU on", "hot functions", "flame graph for a service", "why is this service using so much CPU", "memory allocations by function", "CPU spike by pod", "which version increased CPU", "continuous profiling", "profiling data", or wants to explore profiles of a service. For how much CPU or memory a service or pod uses and whether it is saturated, use `cx-service-catalog` instead.

Quality

98%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

96%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: concrete third-person action list, an explicit 'Use when' clause with a comprehensive set of natural trigger phrases, and an explicit boundary redirecting saturation/usage questions to a sibling skill. No vague language, buzzwords, or padding despite its length — every clause carries either a capability or a trigger/boundary.

DimensionReasoningScore

Specificity

"Query Coralogix continuous-profiling data with the `cx profiling` CLI — find which services use the most CPU or memory, which profile types a service has, what profiles can be filtered by, when usage spiked and which pod or version caused it, and which code paths and functions a service spends its CPU or memory on (flame graphs)" lists multiple concrete actions with comprehensive coverage of the skill's domain, all in third person. It is not 4: the action list covers ranking, metadata, filters, spike attribution, and flame graphs — there are no minor gaps in coverage of what the CLI does.

5 / 5

Completeness

Both parts are explicit: the opening sentence answers "what" (the concrete querying capabilities), and "Use when the user asks ... or wants to explore profiles of a service" answers "when" with concrete quoted trigger phrases — structurally identical to the score-5 anchor example. It is not 4: the "when" clause is fully explicit and specific rather than one that "could be more explicit or specific".

5 / 5

Trigger Term Quality

The description includes eleven natural user-quoted phrases — "which services use the most CPU", "top memory consumers", "what is service X spending CPU on", "hot functions", "flame graph for a service", "why is this service using so much CPU", "memory allocations by function", "CPU spike by pod", "which version increased CPU", "continuous profiling", "profiling data" — plus "wants to explore profiles of a service". It is not 4: natural synonyms and phrasings users would actually say are comprehensively covered, matching the anchor's standard including synonyms.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (Coralogix continuous-profiling data via the `cx profiling` CLI) and it actively disambiguates the nearest conflicting case: "For how much CPU or memory a service or pod uses and whether it is saturated, use `cx-service-catalog` instead." It is not 4: it does not merely have minor overlap risk — it explicitly routes the most likely mis-trigger (resource-usage questions) to the sibling skill.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

coralogix/cx-cli

Path

skills/cx-profiling/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.