Skip to content

feat(datadog): migrate to Agent Plugin format - #207

Draft
CatherineCao2016 wants to merge 4 commits into
kirodotdev:mainfrom
CatherineCao2016:feat/datadog-agent-plugin
Draft

CatherineCao2016 wants to merge 4 commits into
kirodotdev:mainfrom
CatherineCao2016:feat/datadog-agent-plugin

Conversation

@CatherineCao2016

@CatherineCao2016 CatherineCao2016 commented Oct 27, 2026 •

Copy link
Copy Markdown

Summary

Converts the datadog power to an Agent Plugin (spec 1.0.0), following the migration guide in power-builder/skills/migrate-plugin. The Datadog MCP server and its tools are the same. The files are laid out as a plugin, and the instructions now describe how the server is actually set up.

What this PR includes

Before After
POWER.md skills/datadog/SKILL.md
steering/steering.md skills/datadog-query-syntax/SKILL.md
(part of steering) skills/datadog-query-syntax/references/use-cases-and-pitfalls.md
mcp.json mcp.json, now with $schema and type: "streamable-http"
(none) plugin.json

Layout

  • plugin.json has name, version 1.0.0, description, author, homepage, repository and 7 keywords. It omits displayName, extensions and license: the schema is closed and the repo has no root LICENSE.
  • The old steering file was 799 lines. Its Common Use Cases, Anti-Patterns and Performance Tips sections moved into a references/ file so each SKILL.md stays under the guide's 800-line limit. A link is left in their place.
  • mcp.json keeps the same URL, https://mcp.datadoghq.com/v1/mcp. type: "http" becomes "streamable-http", the name the Agent Plugins schema uses.

Content updates in the skills

  • Server description: the skill said the server runs through mcp-remote with npx at an api/unstable URL, and gave a manual config block. It now says it is a remote streamable-HTTP server configured by this plugin's mcp.json, and lists the endpoints for the other Datadog sites (US3, US5, EU, AP1, AP2, UK1).
  • Authentication: the skill said an API key and application key were required. It now says OAuth 2.0 is recommended, with a Personal or Service Access Token, or API and application keys, as alternatives. This follows Datadog's MCP server setup docs.
  • Tool examples: the 30 usePower("datadog", "datadog", "<tool>", {...}) calls are now <tool>({...}). Arguments are unchanged.
  • Onboarding note: it said the server was in preview and needed a request for access. It now says the server is generally available and lists what it needs: an org admin allowing MCP access, a role with MCP Server permissions, and a non-government Datadog site.
  • Removed search_datadog_docs: it is not an official Datadog MCP tool. The documentation-search guidance that relied on it is removed too, including the "Documentation" capability line and the matching phrase in the skill description.
  • Wording: "Power" now says "plugin" where it means this package, and the "Steering Guide" title is "Query Guide".

Behavior change

POWER.md and steering/ are removed. Anything that reads them directly will not find them.

Tests

  • plugin.json and mcp.json validate against the 1.0.0 schemas (jsonschema 4.23.0).
  • Each skill's name matches its folder and has a description with a "Use when" clause.
  • Relative links in the skills resolve.
  • Both SKILL.md files are under 800 lines.
  • Not yet installed in Kiro. This PR stays a draft until that is tested.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Convert the datadog power from the POWER.md layout to Agent Plugins 1.0.0.

- Add plugin.json (name, version, description, author, homepage,
  repository, keywords).
- Move the POWER.md body to skills/datadog/SKILL.md.
- Move steering/steering.md to skills/datadog-query-syntax/SKILL.md, with
  use cases, anti-patterns and performance tips in references/.
- Normalize mcp.json to the 1.0.0 MCP schema ($schema, type
  streamable-http).
- Point the two references to the old steering file at the new skill.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant