Skip to content

add integration skill#7568

Merged
wconti27 merged 9 commits intomasterfrom
conti/integration-skill
Feb 23, 2026
Merged

add integration skill#7568
wconti27 merged 9 commits intomasterfrom
conti/integration-skill

Conversation

@wconti27
Copy link
Copy Markdown
Contributor

@wconti27 wconti27 commented Feb 18, 2026

Adds a Claude skill for integrations. Uses skill best practices including limiting Skill.MD to under 300 lines, and using reference links in the MD to reference files that hold more specific information. Pulls in information from the recently added PR for adding a new integration, and adds this information as a reference for new integration implementation guide. Prioritizes orchestrion for writing new integrations.

#7564

What does this PR do?

Motivation

Additional Notes

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Feb 18, 2026

Overall package size

Self size: 4.78 MB
Deduped: 5.62 MB
No deduping: 5.62 MB

Dependency sizes | name | version | self size | total size | |------|---------|-----------|------------| | import-in-the-middle | 2.0.6 | 81.92 kB | 816.75 kB | | dc-polyfill | 0.1.10 | 26.73 kB | 26.73 kB |

🤖 This report was automatically generated by heaviest-objects-in-the-universe

@codecov
Copy link
Copy Markdown

codecov Bot commented Feb 18, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 80.31%. Comparing base (631fb6a) to head (4311b6c).
⚠️ Report is 7 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #7568      +/-   ##
==========================================
- Coverage   80.32%   80.31%   -0.01%     
==========================================
  Files         733      733              
  Lines       31546    31546              
==========================================
- Hits        25338    25336       -2     
- Misses       6208     6210       +2     
Flag Coverage Δ
aiguard-macos 38.93% <ø> (-0.11%) ⬇️
aiguard-ubuntu 39.05% <ø> (-0.11%) ⬇️
aiguard-windows 38.79% <ø> (-0.11%) ⬇️
apm-capabilities-tracing-macos 48.63% <ø> (ø)
apm-capabilities-tracing-ubuntu 48.66% <ø> (ø)
apm-capabilities-tracing-windows 48.35% <ø> (ø)
apm-integrations-child-process 38.50% <ø> (-0.10%) ⬇️
apm-integrations-couchbase-18 37.27% <ø> (-0.25%) ⬇️
apm-integrations-couchbase-eol 37.75% <ø> (-0.25%) ⬇️
apm-integrations-oracledb 37.73% <ø> (-0.10%) ⬇️
appsec-express 55.52% <ø> (-0.08%) ⬇️
appsec-fastify 51.84% <ø> (-0.07%) ⬇️
appsec-graphql 52.03% <ø> (-0.07%) ⬇️
appsec-kafka 44.48% <ø> (-0.15%) ⬇️
appsec-ldapjs 44.09% <ø> (-0.09%) ⬇️
appsec-lodash 43.77% <ø> (-0.08%) ⬇️
appsec-macos 58.61% <ø> (-0.07%) ⬇️
appsec-mongodb-core 48.95% <ø> (-0.08%) ⬇️
appsec-mongoose 49.64% <ø> (-0.08%) ⬇️
appsec-mysql 51.01% <ø> (-0.07%) ⬇️
appsec-node-serialize 43.29% <ø> (-0.09%) ⬇️
appsec-passport 47.78% <ø> (-0.09%) ⬇️
appsec-postgres 50.75% <ø> (-0.10%) ⬇️
appsec-sourcing 42.64% <ø> (-0.09%) ⬇️
appsec-template 43.46% <ø> (-0.09%) ⬇️
appsec-ubuntu 58.68% <ø> (-0.07%) ⬇️
appsec-windows 58.46% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-bluebird 32.20% <ø> (-0.11%) ⬇️
instrumentations-instrumentation-body-parser 40.51% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-child_process 37.82% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-cookie-parser 34.24% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-express 34.58% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-express-mongo-sanitize 34.37% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-express-session 40.13% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-fs 31.80% <ø> (-0.11%) ⬇️
instrumentations-instrumentation-generic-pool 29.76% <ø> (ø)
instrumentations-instrumentation-http 39.85% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-knex 32.20% <ø> (-0.11%) ⬇️
instrumentations-instrumentation-mongoose 33.37% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-multer 40.25% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-mysql2 38.29% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-passport 44.09% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-passport-http 43.76% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-passport-local 44.30% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-pg 37.71% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-promise 32.13% <ø> (-0.11%) ⬇️
instrumentations-instrumentation-promise-js 32.13% <ø> (-0.11%) ⬇️
instrumentations-instrumentation-q 32.18% <ø> (-0.11%) ⬇️
instrumentations-instrumentation-url 32.10% <ø> (-0.11%) ⬇️
instrumentations-instrumentation-when 32.15% <ø> (-0.11%) ⬇️
llmobs-ai 41.33% <ø> (-0.24%) ⬇️
llmobs-anthropic 40.32% <ø> (-0.10%) ⬇️
llmobs-bedrock 39.25% <ø> (-0.09%) ⬇️
llmobs-google-genai 39.84% <ø> (-0.09%) ⬇️
llmobs-langchain 39.43% <ø> (-0.08%) ⬇️
llmobs-openai 44.14% <ø> (-0.09%) ⬇️
llmobs-vertex-ai 40.04% <ø> (-0.11%) ⬇️
platform-core 29.71% <ø> (ø)
platform-esbuild 32.89% <ø> (ø)
platform-instrumentations-misc 40.53% <ø> (ø)
platform-shimmer 36.14% <ø> (ø)
platform-unit-guardrails 31.27% <ø> (ø)
plugins-azure-event-hubs 24.02% <ø> (ø)
plugins-azure-service-bus 23.42% <ø> (ø)
plugins-bullmq 43.66% <ø> (-0.10%) ⬇️
plugins-cassandra 37.77% <ø> (-0.10%) ⬇️
plugins-cookie 25.08% <ø> (ø)
plugins-cookie-parser 24.87% <ø> (ø)
plugins-crypto 24.72% <ø> (ø)
plugins-dd-trace-api 38.36% <ø> (-0.11%) ⬇️
plugins-express-mongo-sanitize 25.04% <ø> (ø)
plugins-express-session 24.83% <ø> (ø)
plugins-fastify 42.27% <ø> (-0.10%) ⬇️
plugins-fetch 38.32% <ø> (-0.10%) ⬇️
plugins-fs 38.61% <ø> (-0.11%) ⬇️
plugins-generic-pool 24.06% <ø> (ø)
plugins-google-cloud-pubsub 45.46% <ø> (-0.09%) ⬇️
plugins-grpc 40.97% <ø> (-0.10%) ⬇️
plugins-handlebars 25.08% <ø> (ø)
plugins-hapi 40.14% <ø> (-0.10%) ⬇️
plugins-hono 40.41% <ø> (-0.10%) ⬇️
plugins-ioredis 38.41% <ø> (-0.10%) ⬇️
plugins-knex 24.80% <ø> (ø)
plugins-ldapjs 22.61% <ø> (ø)
plugins-light-my-request 24.48% <ø> (ø)
plugins-limitd-client 32.34% <ø> (-0.26%) ⬇️
plugins-lodash 24.13% <ø> (ø)
plugins-mariadb 39.54% <ø> (-0.05%) ⬇️
plugins-memcached 38.15% <ø> (-0.11%) ⬇️
plugins-microgateway-core 39.17% <ø> (-0.10%) ⬇️
plugins-moleculer 40.53% <ø> (-0.10%) ⬇️
plugins-mongodb 39.20% <ø> (-0.17%) ⬇️
plugins-mongodb-core 39.03% <ø> (-0.10%) ⬇️
plugins-mongoose 38.85% <ø> (-0.10%) ⬇️
plugins-multer 24.83% <ø> (ø)
plugins-mysql 39.14% <ø> (-0.13%) ⬇️
plugins-mysql2 39.27% <ø> (-0.10%) ⬇️
plugins-node-serialize 25.12% <ø> (ø)
plugins-opensearch 37.60% <ø> (-0.10%) ⬇️
plugins-passport-http 24.91% <ø> (ø)
plugins-postgres 35.69% <ø> (-0.09%) ⬇️
plugins-process 24.72% <ø> (ø)
plugins-pug 25.08% <ø> (ø)
plugins-redis 38.89% <ø> (-0.10%) ⬇️
plugins-router 43.03% <ø> (-0.10%) ⬇️
plugins-sequelize 23.66% <ø> (ø)
plugins-test-and-upstream-amqp10 38.33% <ø> (-0.25%) ⬇️
plugins-test-and-upstream-amqplib 43.85% <ø> (-0.11%) ⬇️
plugins-test-and-upstream-apollo 39.03% <ø> (-0.09%) ⬇️
plugins-test-and-upstream-avsc 38.70% <ø> (-0.11%) ⬇️
plugins-test-and-upstream-bunyan 33.79% <ø> (-0.11%) ⬇️
plugins-test-and-upstream-connect 40.81% <ø> (-0.10%) ⬇️
plugins-test-and-upstream-graphql 40.15% <ø> (-0.10%) ⬇️
plugins-test-and-upstream-koa 40.39% <ø> (-0.10%) ⬇️
plugins-test-and-upstream-protobufjs 38.93% <ø> (-0.11%) ⬇️
plugins-test-and-upstream-rhea 44.13% <ø> (-0.10%) ⬇️
plugins-undici 39.11% <ø> (-0.09%) ⬇️
plugins-url 24.72% <ø> (ø)
plugins-valkey 38.04% <ø> (-0.13%) ⬇️
plugins-vm 24.72% <ø> (ø)
plugins-winston 33.99% <ø> (-0.10%) ⬇️
plugins-ws 41.91% <ø> (-0.10%) ⬇️
profiling-macos 39.84% <ø> (-0.10%) ⬇️
profiling-ubuntu 39.97% <ø> (-0.10%) ⬇️
profiling-windows 41.20% <ø> (-0.10%) ⬇️
serverless-azure-functions-client 23.75% <ø> (ø)
serverless-azure-functions-eventhubs 23.75% <ø> (ø)
serverless-azure-functions-servicebus 23.75% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@datadog-datadog-prod-us1

This comment has been minimized.

@pr-commenter
Copy link
Copy Markdown

pr-commenter Bot commented Feb 18, 2026

Benchmarks

Benchmark execution time: 2026-02-23 08:59:47

Comparing candidate commit 4311b6c in PR branch conti/integration-skill with baseline commit 631fb6a in branch master.

Found 0 performance improvements and 0 performance regressions! Performance is the same for 231 metrics, 29 unstable metrics.

Comment thread .gitignore
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@wconti27 wconti27 marked this pull request as ready for review February 19, 2026 16:21
@wconti27 wconti27 requested a review from a team as a code owner February 19, 2026 16:21
tlhunter
tlhunter previously approved these changes Feb 19, 2026
Copy link
Copy Markdown
Member

@tlhunter tlhunter left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems fine... But does every LLM call now use a ton of tokens?

@wconti27
Copy link
Copy Markdown
Contributor Author

@codex review

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 92e3cb67f6

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .agents/skills/apm-integrations/references/testing.md
Comment thread .agents/skills/apm-integrations/references/testing.md Outdated
Comment thread .agents/skills/apm-integrations/references/orchestrion.md Outdated
@wconti27
Copy link
Copy Markdown
Contributor Author

wconti27 commented Feb 19, 2026

Seems fine... But does every LLM call now use a ton of tokens?
@tlhunter

The token counts are as follows, keep in mind, at startup, only the front matter (skill name + description are loaded, few hundred tokens). When the llm triggers the skill to use it, only SKILL.md is loaded, and the agent loads additional reference files as needed. But even with the full token count, its less than 5% current agent context limits.

  ┌──────────────────────────┬───────┬─────────┐                                                                                                                                                                   
  │           File           │ Words │ ~Tokens │                                                                                                                                                                 
  ├──────────────────────────┼───────┼─────────┤                                                                                                                                                                   
  │ SKILL.md                 │ 891   │ ~1,160  │                                                                                                                                                                   
  ├──────────────────────────┼───────┼─────────┤                                                                                                                                                                   
  │ new-integration-guide.md │ 1,215 │ ~1,580  │                                                                                                                                                                   
  ├──────────────────────────┼───────┼─────────┤
  │ orchestrion.md           │ 949   │ ~1,230  │
  ├──────────────────────────┼───────┼─────────┤
  │ plugin-patterns.md       │ 685   │ ~890    │
  ├──────────────────────────┼───────┼─────────┤
  │ reference-plugins.md     │ 271   │ ~350    │
  ├──────────────────────────┼───────┼─────────┤
  │ testing.md               │ 715   │ ~930    │
  ├──────────────────────────┼───────┼─────────┤
  │ Total                    │ 4,726 │ ~6,140  │
  └──────────────────────────┴───────┴─────────┘

wconti27 and others added 2 commits February 19, 2026 13:06
- Add missing imports (assert, ANY_STRING) to test template
- Fix error.stackTrace → error.stack to match dd-trace constants
- Remove incorrect claim that orchestrion auto-handles CJS/ESM splits
- Convert all cross-references to proper markdown links

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
tlhunter
tlhunter previously approved these changes Feb 19, 2026
Comment on lines +4 to +13
This skill should be used when the user asks to "add a new integration",
"create a new plugin", "instrument a library", "add instrumentation for",
"write a plugin", "create instrumentation", "new dd-trace plugin",
"add tracing for", "TracingPlugin", "DatabasePlugin", "CachePlugin",
"ClientPlugin", "ServerPlugin", "CompositePlugin", "ConsumerPlugin",
"ProducerPlugin", "addHook", "shimmer.wrap", "orchestrion",
"bindStart", "bindFinish", "startSpan", "diagnostic channel",
"runStores", "reference plugin", "example plugin", "similar integration",
or needs to build, modify, or debug the instrumentation and plugin layers
for a third-party library in dd-trace-js.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: I think there's a difference between adding new instrumentation, and adding a new plugin. You can add a new plugin without having it be related to instrumentation. In that case, do we really want to the agent to try this skill?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Taken into account, though for placing the new plugin creation into another skill, I do not think that's the right move. Considering that plugins rely on the instrumentation side, and the LLM should have some context on instrumentations when writing any plugin.

Comment thread .agents/skills/apm-integrations/SKILL.md
Comment thread .agents/skills/apm-integrations/SKILL.md
@wconti27 wconti27 merged commit 5e3de4e into master Feb 23, 2026
792 checks passed
@wconti27 wconti27 deleted the conti/integration-skill branch February 23, 2026 09:16
dd-octo-sts Bot pushed a commit that referenced this pull request Feb 24, 2026
* add APM integration skill, which covers instrumentation, plugins, a new integration guide, and reference integrations.
@dd-octo-sts dd-octo-sts Bot mentioned this pull request Feb 24, 2026
juan-fernandez pushed a commit that referenced this pull request Mar 5, 2026
* add APM integration skill, which covers instrumentation, plugins, a new integration guide, and reference integrations.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants