Skip to content

feat(skills): add catalog and session commands backed by Datadog API#614

Draft
rachelyangdog wants to merge 3 commits into
DataDog:mainfrom
rachelyangdog:rachel.yang/skills-catalog-session-commands
Draft

feat(skills): add catalog and session commands backed by Datadog API#614
rachelyangdog wants to merge 3 commits into
DataDog:mainfrom
rachelyangdog:rachel.yang/skills-catalog-session-commands

Conversation

@rachelyangdog

Copy link
Copy Markdown
Contributor

Adds three new subcommands under pup skills that talk to the agentic-onboarding-api:

  • pup skills catalog list [--tags <tag>...] — lists skills from the remote registry (GET /api/v2/skills), optionally filtered by tag (e.g. --tags apm)
  • pup skills catalog get <name> — fetches a single skill's full content by name (GET /api/v2/skills/)
  • pup skills session — records an onboarding session checkpoint or terminal event (POST /api/v2/onboarding/sessions) using the JSON:API envelope the service expects

These complement the existing local skills list/install/path commands (which manage bundled skill files on disk) by giving Claude and other agents a way to discover domain skills from the registry and record session telemetry.

What does this PR do?

Motivation

Additional Notes

Checklist

  • The code change follows the project conventions (see CONTRIBUTING.md)
  • Tests have been added/updated (if applicable)
  • Documentation has been updated (if applicable)
  • All CI checks pass
  • Code coverage is maintained or improved

Related Issues

Adds three new subcommands under `pup skills` that talk to the agentic-onboarding-api:

- `pup skills catalog list [--tags <tag>...]` — lists skills from the remote
  registry (GET /api/v2/skills), optionally filtered by tag (e.g. --tags apm)
- `pup skills catalog get <name>` — fetches a single skill's full content by
  name (GET /api/v2/skills/<name>)
- `pup skills session` — records an onboarding session checkpoint or terminal
  event (POST /api/v2/onboarding/sessions) using the JSON:API envelope the
  service expects

These complement the existing local `skills list/install/path` commands (which
manage bundled skill files on disk) by giving Claude and other agents a way to
discover domain skills from the registry and record session telemetry.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@rachelyangdog rachelyangdog requested a review from a team as a code owner June 23, 2026 13:58
@rachelyangdog rachelyangdog marked this pull request as draft June 23, 2026 13:58
rachelyangdog and others added 2 commits June 23, 2026 11:18
Adds two more subcommands under `pup skills catalog`:

- `publish <file> --name <name> [--description <desc>] [--tags <tag>...]`
  Creates a new skill in the remote catalog via POST /api/v2/skills
- `update <file> --name <name> [--description <desc>] [--tags <tag>...]`
  Updates an existing skill via PUT /api/v2/skills/{name}

Both read the skill markdown from a local file and upload it as the
skill content. This makes it easy to publish multi-file skill trees
like dd-apm to the registry with a simple shell loop.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Thin skill that tells Claude to fetch the orchestrator from the
agentic-onboarding-api before any Datadog setup or install task.
Closes the delivery gap: customers running `pup skills install` now
get the entry point for the live skill chain in dd-source.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@datadog-datadog-prod-us1

datadog-datadog-prod-us1 Bot commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Pipelines

Fix all issues with BitsAI

⚠️ Warnings

🚦 2 Pipeline jobs failed

CI | Check, Test &amp; Coverage   View in Datadog   GitHub Actions

CI | Cross Compile (Windows)   View in Datadog   GitHub Actions

Useful? React with 👍 / 👎

This comment will be updated automatically if new data arrives.
🔗 Commit SHA: 9b639a3 | Docs | Datadog PR Page | Give us feedback!

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