CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

weave-instrument

Add Weave tracing to Python or TypeScript agents and LLM applications. Use when asked to instrument model calls, tools, or agent turns with Weave.

Quality

92%

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

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

An exemplary instruction-only skill body: a hard login gate, a clear mechanism-selection decision list, incremental implementation with per-change read-back verification, and explicit unverified-means-stop boundaries. The only nit is mild redundancy in the login section's repeated stop/send-only instructions.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and assumes Claude's competence (no explaining what Weave or tracing is), but the login section restates the stop/send-only instruction already given at the top ('Send only this, and nothing else. No decisions, notes, plans, or documentation links') and repeats credential-handling cautions ('never read, print, or commit API keys' / 'never print, copy, or inspect secret values').

4 / 5

Actionability

Gives copy-paste-ready commands ('weave.init("entity/project")' in Python or 'await weave.init(...)' in Node, 'wandb login --verify --host <base-url>'), an exact user-facing reply template, and concrete check targets ('INTEGRATION_MODULE_MAPPING', 'integrations/hooks.ts', 'gen_ai.operation.name' values 'invoke_agent'/'chat'/'execute_tool'). Per the code-vs-instruction scoring note, deferring span code to real reference files is not penalized.

5 / 5

Workflow Clarity

The sequence is explicitly gated (login check first, then inspect dependencies/agent boundaries/OTel provider, choose mechanism, implement one traced path at a time, then verify) with a real feedback loop: 'Fix mismatches and rerun the same check before continuing' and 'Empty results, failed queries, and unavailable checks are unverified, not passes. Stop at that boundary.'

5 / 5

Progressive Disclosure

The body is a lean overview with six well-signaled, topical, one-level-deep references ([trace_fidelity](references/trace_fidelity.md), [Python](references/session_sdk_python.md) / [TypeScript](references/session_sdk_typescript.md) session SDKs, [auto-instrumentation caveats](references/otel_auto.md), [endpoint configuration](references/otel_endpoint.md), [read-back verification](references/read_back.md)), and all six files exist in ./references/ with no further nesting.

5 / 5

Total

19

/

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 that explicitly answers both what the skill does and when to use it, in third person, with concrete, natural trigger terms. The only gaps are minor: a few missing synonyms (W&B, observability) and unmentioned capabilities like OTel-pipeline export.

Suggestions

Consider adding common synonyms such as 'W&B' or 'observability/monitoring' to the trigger clause so users who do not say 'Weave' verbatim still match.

Optionally mention additional concrete capabilities (e.g., exporting traces from an existing OpenTelemetry pipeline) to move specificity toward comprehensive coverage.

DimensionReasoningScore

Specificity

'Add Weave tracing to Python or TypeScript agents and LLM applications' names the domain and 'instrument model calls, tools, or agent turns' lists several concrete actions, matching anchor 4. It falls short of anchor 5's comprehensive coverage because actions like initializing at startup or exporting from an existing OTel pipeline are not mentioned, and it exceeds anchor 3's 1-2 actions.

4 / 5

Completeness

Both parts are explicit: the 'what' is 'Add Weave tracing to Python or TypeScript agents and LLM applications' and the 'when' is 'Use when asked to instrument model calls, tools, or agent turns with Weave' with concrete trigger phrases, exactly matching anchor 5. A 4 would require the 'when' to be less explicit or specific, which is not the case.

5 / 5

Trigger Term Quality

Natural trigger phrases are present ('Weave tracing', 'instrument model calls', 'tools', 'agent turns', 'LLM applications'), giving good coverage, but common synonyms a user might say are missing ('W&B', 'observability', 'monitoring', 'trace my agent'), so it fits anchor 4 rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'Weave' is a distinctive niche qualifier and the trigger is bound to it ('...with Weave'), so overlap with generic tracing/observability skills is minimal — a clear anchor-5 fit. It is not a 4 because no closely related skill would plausibly capture these 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

wandb/skills

Path

skills/weave-instrument/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.