service-catalog

Manage Datadog Service Catalog definitions, entities, kinds, and relations via the pup CLI.

5|2|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/lauhon/pi --skill service-catalog-lauhon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: service-catalog
Source: https://github.com/lauhon/pi/tree/main/skills/service-catalog
Command: npx skills add https://github.com/lauhon/pi --skill service-catalog-lauhon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a microservices catalog accurate is tedious: teams must register services, track ownership, map dependencies, and maintain metadata across many APIs. This Skill automates those Datadog Service Catalog operations through the pup CLI so catalog data stays current. ## Core Features & Use Cases - Service Definition Management: List, get, create, update, and delete service definitions across schema versions v2 through v2.2, including ownership, contacts, links, tags, and integrations like PagerDuty and OpsGenie. - Software Catalog Entities: Manage catalog entities (services, datastores, queues, systems, APIs), define custom entity kinds, and preview definitions before creation. - Relationship Mapping: Create and query relations such as dependsOn, ownedBy, and partOf to build dependency graphs between services and teams. - Use Case: When onboarding a new payment service, register it with team ownership and runbook links, then create dependsOn relations to its database and queue so the dependency map reflects reality. ## Quick Start Ask the agent to list all services in your Datadog Service Catalog grouped by team and tier.

Frequently Asked Questions about service-catalog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I register a new service in Datadog Service Catalog?

Create a service definition YAML file with schema-version, dd-service, team, contacts, and links, then run pup services create with the definition file. The agent asks for confirmation before creating the service.

How do I map service dependencies in Datadog?

Use pup catalog relations create with a source entity, target entity, and relation type such as dependsOn or ownedBy. You can then list relations filtered by source to view a service's dependency graph.

What schema versions does Datadog Service Definition support?

The catalog supports schema versions v2, v2.1, and v2.2, with v2.2 recommended for full feature support and improved validation. Version v1 is deprecated and should be migrated to v2.2.

What credentials are required to use the Datadog Service Catalog API?

You need three environment variables: DD_API_KEY for the Datadog API key, DD_APP_KEY for the application key, and DD_SITE for the Datadog site, which defaults to datadoghq.com.

Can I validate a catalog entity before creating it?

Yes, run pup catalog entities preview with your entity definition file to validate the YAML structure and schema before creation. This catches invalid fields and missing required properties early.

Why does service creation fail with a duplicate service error?

The error means a service with that name already exists in the catalog. Use pup services update with the existing service name to modify its definition instead of creating a new one.