CtrlK
BlogDocsLog inGet started
Tessl Logo

datadog-cli

Datadog CLI for searching logs, querying metrics, tracing requests, and managing dashboards. Use this when debugging production issues or working with Datadog observability.

92

1.43x
Quality

89%

Does it follow best practices?

Impact

96%

1.43x

Average score across 6 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is datadog-cli in softaworks/agent-toolkit

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 well-structured, highly actionable CLI skill: every example is executable, the bundle is properly split into real one-level-deep reference files, and the triage workflow gives a sensible debugging sequence. The main weaknesses are minor: command duplication between Quick Examples and the triage workflow, and a lack of explicit decision/validation checkpoints in that workflow.

Suggestions

Deduplicate the commands that appear in both Quick Examples and the Incident Triage Workflow ('logs search', 'logs compare', 'logs trace', 'errors') — keep one canonical example per command and let the workflow steps reference them by name.

Add explicit decision checkpoints to the Incident Triage Workflow, e.g. 'if logs compare shows a spike, run logs patterns to identify the culprit; otherwise widen the timeframe or check metrics' — this turns the sequence into a feedback loop.

Consider pointing the 'Required Reading' mandate at the specific reference per command group (e.g. log commands → logs-commands.md) rather than requiring all relevant docs before any command, to avoid loading unnecessary context for simple queries.

DimensionReasoningScore

Conciseness

The body is dense and efficient — tables of commands/flags and executable code with no conceptual padding — but the Quick Examples section repeats four commands ('logs search', 'logs compare', 'logs trace', 'errors') that reappear nearly verbatim in the Incident Triage Workflow, so a few tokens could be trimmed. It fits anchor 4 ('efficient; minor instances that could be trimmed') rather than 5 because of this duplication, and not 3 since nothing over-explains concepts Claude already knows.

4 / 5

Actionability

Fully executable, copy-paste-ready commands with realistic values throughout: 'npx @leoflores/datadog-cli logs search --query "status:error" --from 1h --pretty', 'metrics query --query "avg:system.cpu.user{*}"', env-var setup with the key-management URL, and a non-US site example ('--site datadoghq.eu'). The only placeholder ('--id "TRACE_ID"') is conventional in a template step and a realistic value appears in Quick Examples, so this matches the anchor 5 'fully executable; common cases covered' rather than 4.

5 / 5

Workflow Clarity

The 'Incident Triage Workflow' is a clearly sequenced, purpose-annotated 6-step pipeline (errors overview → 'Is this new? Compare to previous period' → patterns → narrow by service → context → trace), but decision checkpoints are implicit — there is no 'if compare shows a spike, then…' guidance or validation feedback loop. This lands on anchor 4 ('clear sequence with most checkpoints present; minor validation gaps'), not 5 (no explicit validation steps) and not 3 (the sequence is explicit and commented, not merely listed). All workflow operations are read-only queries, so the destructive/batch cap does not apply.

4 / 5

Progressive Disclosure

The body stays an overview (command table, flags, examples) and clearly signals one-level-deep references — all five linked files (logs-commands.md, metrics.md, query-syntax.md, workflows.md, dashboards.md) exist in the bundle and hold the ~530 lines of detail. The single lateral cross-link in workflows.md points to a sibling file as navigation, not nesting, so this matches anchor 5 ('clear overview with well-signaled one-level-deep references; content appropriately split') rather than 4.

5 / 5

Total

18

/

20

Passed

Description

87%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.

A strong description: third-person voice, four concrete capability actions, an explicit 'Use this when…' trigger clause, and a brand-anchored niche that eliminates conflict risk. The only improvement space is adding a few more natural trigger synonyms (incident, alerts, monitoring) and covering the error-triage commands the body emphasizes.

DimensionReasoningScore

Specificity

The description lists four concrete actions — 'searching logs, querying metrics, tracing requests, and managing dashboards' — covering Datadog's main pillars. It fits anchor 4 ('several specific actions; minor gaps in coverage') rather than 5 because the skill also performs error summaries, service listing, and dashboard-list management (all top-level commands in the body) that the description omits; it is well above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

It explicitly answers both questions: what ('Datadog CLI for searching logs, querying metrics, tracing requests, and managing dashboards') and when ('Use this when debugging production issues or working with Datadog observability'). This matches anchor 5's pattern exactly — a concrete what plus an explicit 'Use when…' clause with concrete trigger phrases — rather than anchor 4, where the 'when' would be less specific.

5 / 5

Trigger Term Quality

Natural trigger terms include 'Datadog observability', 'debugging production issues', 'logs', 'metrics', 'tracing requests', and 'dashboards' — the brand name plus the domain nouns a user would actually say. It fits anchor 4 ('good keyword coverage; a few natural terms missing') because common variations like 'incident', 'alerts', 'monitoring', or 'on-call' are absent, keeping it below the synonym-level coverage of anchor 5 but well above the sparse keyword sets of anchor 3.

4 / 5

Distinctiveness Conflict Risk

The 'Datadog' brand names a clear niche with distinct triggers; no other plausible skill would claim 'searching logs, querying metrics, tracing requests' against a Datadog request. Minimal conflict risk, matching anchor 5 ('clear niche with distinct triggers').

5 / 5

Total

18

/

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
davila7/claude-code-templates
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.