CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apm-integrations

Use when adding, debugging, fixing, or modifying instrumentation and plugins for third-party libraries in dd-trace-js. Triggers: "add a new integration", "instrument a library", any *Plugin base class (Tracing/Database/Cache/ Client/Server/Consumer/Producer/Composite), "addHook", "shimmer.wrap", "orchestrion", "bindStart"/"bindFinish", "diagnostic channel", "runStores", "subscriber cardinality", "channel.publish gate", "read upstream source", "reference plugin".

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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 skill body: architecture, decision rules, commands, registration surfaces, debugging, and workflow are all concrete and project-specific, with detail correctly pushed to five flat, well-signaled reference files. The only trimmable fat is a handful of redundant restatements that repeat rules already stated in the same section.

DimensionReasoningScore

Conciseness

The body is dense with project-specific knowledge (two-layer architecture, base-class hierarchy, channel naming, subscriber cardinality) and never explains general concepts Claude already knows, but contains a few redundant restatements — "Always try to use Orchestrion when beginning a new integration!" repeats the section's opening rule, and "Always match the library type to the base class" restates "Wrong base class = complex workarounds" — fitting the 4 anchor (efficient, minor trimmable instances) rather than the every-token-earns-its-place standard of 5.

4 / 5

Actionability

Copy-paste-ready commands throughout (git clone --depth 1, npm pack + tar extraction, PLUGINS="<name>" npm run test:plugins:ci, docker compose up -d, DD_TRACE_DEBUG=true), exact registration paths (plugins/index.js, docs/test.ts, docs/API.md, .github/workflows/apm-integrations.yml), and concrete decision criteria for orchestrion-vs-shimmer with valid fallback reasons. Fully executable with specific examples covering the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

The Implementation Workflow is a clearly sequenced 7-step process with concrete commands and an explicit validation checkpoint ("Confirm all tests pass before marking work as complete"), and the Debugging section provides symptom→cause→fix mappings (e.g., "Spans missing → verify hasSubscribers guard") as the error-recovery loop, with a checklist delegated to the integration guide reference. Matches the 5 anchor: explicit validation, feedback loops, and checklist coverage; no destructive/batch validation cap applies since the workflow is code implementation verified by tests.

5 / 5

Progressive Disclosure

The ~180-line body is an appropriate overview that splits detail across five reference files, each signaled inline at its point of use ([Orchestrion Reference] beside the config discussion, [Testing] in the test-writing step) and cataloged in a Reference Files section. All five referenced paths were verified to exist as substantive files (98–324 lines) with no nested references — one level deep — matching the 5 anchor for clear, well-signaled, flat structure.

5 / 5

Total

19

/

20

Passed

Description

83%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 highly specific, well-triggered description that clearly carves out its niche and would reliably fire for the right requests. The only weakness is that the capability statement lives inside the "Use when" clause rather than standing on its own, and a handful of natural user phrasings around tracing/datadog plugins are absent from the trigger list.

Suggestions

Lead with an independent capability statement before the "Use when" clause, e.g., "Creates and modifies dd-trace-js integrations: instrumentation + plugin layers communicating via diagnostic channels."

Add a few natural trigger phrasings users would actually say, such as "add tracing to <library>", "dd-trace integration", or datadog-plugin-<name> package paths.

DimensionReasoningScore

Specificity

Names four concrete actions ("adding, debugging, fixing, or modifying") on precisely identified artifacts ("instrumentation and plugins for third-party libraries in dd-trace-js"), comprehensively covering the skill's scope. Fits the 5 anchor rather than 4 because the action verbs cover every top-level task the skill addresses, with no coverage gaps relative to the body.

5 / 5

Completeness

The "Use when..." clause is explicit and paired with a concrete trigger list, and the action verbs convey the "what", but the capability statement is embedded inside the when-clause rather than stated independently (compare "Extract text and tables from PDF files, fill forms, merge documents. Use when..."). Both what and when are present with the what slightly less explicit, matching the 4 anchor; it is well above 3 because the when is maximally explicit rather than weakly implied.

4 / 5

Trigger Term Quality

Strong trigger list mixing natural phrases ("add a new integration", "instrument a library", "read upstream source") with technical identifiers (orchestrion, shimmer.wrap, runStores, plugin base classes). A few natural user phrasings are missing — e.g., "add tracing to <library>", "dd-trace integration", or datadog-plugin package paths — which fits the 4 anchor (good coverage, a few natural terms missing) rather than the comprehensive-synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

Triggers are dd-trace-js-specific identifiers (orchestrion, addHook, runStores, subscriber cardinality, the *Plugin base-class family) that no other skill would claim, giving a clear niche with minimal conflict risk. No neighboring anchor fits better since even generic terms like "diagnostic channel" are anchored by the dd-trace-js domain qualifier.

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

DataDog/dd-trace-js

Path

.agents/skills/apm-integrations/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.