Skip to content

Conversation

@sergical
Copy link
Member

Summary

  • Add /.well-known/skills/index.json endpoint for agent skills auto-discovery
  • Update generate-skill.ts to output SKILL.md to both plugin and well-known paths
  • Follows the Cloudflare Agent Skills Discovery RFC pattern

Test plan

  • Verify bun run docs:dev serves /.well-known/skills/index.json with valid JSON
  • Verify /.well-known/skills/sentry-cli/SKILL.md returns the skill file
  • Verify bun run build includes files in dist output
  • After deploy, test with npx skills add https://cli.sentry.dev

🤖 Generated with Claude Code

@github-actions
Copy link

github-actions bot commented Jan 30, 2026

Semver Impact of This PR

🟢 Patch (bug fixes)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).


New Features ✨

  • (api) Add custom User-Agent header to API requests by BYK in #125
  • (docs) Add Sentry SDK for error tracking, replay, and metrics by betegon in #122
  • (project) Improve project list and view output by betegon in #129
  • (telemetry) Improve Sentry instrumentation by BYK in #127

Bug Fixes 🐛

  • (npx) Suppress Node.js warnings in npm package by BYK in #115

Documentation 📚

  • (skill) Add well-known skills discovery endpoint by sergical in #135

Internal Changes 🔧

  • Allow PRs to merge when CI jobs are skipped by BYK in #123

🤖 This preview updates automatically when you update the PR.

@github-actions
Copy link

github-actions bot commented Jan 30, 2026

PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://cli.sentry.dev/pr-preview/pr-135/

Built to branch gh-pages at 2026-01-30 21:06 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@github-actions
Copy link

github-actions bot commented Jan 30, 2026

Codecov Results 📊

✅ Patch coverage is 100.00%. Project has 1760 uncovered lines.
✅ Project coverage is 67.66%. Comparing base (base) to head (head).

Files with missing lines (24)
File Patch % Lines
human.ts 30.90% ⚠️ 682 Missing
resolve-target.ts 18.93% ⚠️ 257 Missing
oauth.ts 25.39% ⚠️ 191 Missing
resolver.ts 3.23% ⚠️ 120 Missing
api-client.ts 67.61% ⚠️ 103 Missing
errors.ts 5.94% ⚠️ 95 Missing
migration.ts 47.44% ⚠️ 82 Missing
api.ts 89.80% ⚠️ 47 Missing
seer.ts 75.54% ⚠️ 45 Missing
errors.ts 73.17% ⚠️ 33 Missing
seer.ts 76.15% ⚠️ 31 Missing
preload.ts 39.02% ⚠️ 25 Missing
detector.ts 87.79% ⚠️ 16 Missing
auth.ts 94.21% ⚠️ 7 Missing
index.ts 95.06% ⚠️ 4 Missing
colors.ts 91.84% ⚠️ 4 Missing
telemetry.ts 97.28% ⚠️ 4 Missing
schema.ts 88.00% ⚠️ 3 Missing
env-file.ts 97.17% ⚠️ 3 Missing
utils.ts 98.64% ⚠️ 2 Missing
alias.ts 98.56% ⚠️ 2 Missing
project-aliases.ts 97.40% ⚠️ 2 Missing
java.ts 97.22% ⚠️ 1 Missing
parser.ts 98.63% ⚠️ 1 Missing
Coverage diff
@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
+ Coverage    67.66%    67.66%        —%
==========================================
  Files           47        47         —
  Lines         5442      5442         —
  Branches         0         0         —
==========================================
+ Hits          3682      3682         —
- Misses        1760      1760         —
- Partials         0         0         —

Generated by Codecov Action

Add `/.well-known/skills/index.json` endpoint to cli.sentry.dev for
agent skills auto-discovery, following the Cloudflare Agent Skills
Discovery RFC pattern.

- Create skills manifest at `docs/public/.well-known/skills/index.json`
- Update generate-skill.ts to output SKILL.md to both plugin and
  well-known paths
- Update generate-skill.yml workflow to commit both SKILL.md files
- Enables `npx skills add https://cli.sentry.dev` to auto-discover
  and install the sentry-cli skill

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@sergical sergical force-pushed the feat/well-known-skills-discovery branch from 0a3cd56 to 395fd1f Compare January 30, 2026 20:41
@BYK BYK changed the title feat(docs): add well-known skills discovery endpoint docs(skill): add well-known skills discovery endpoint Jan 30, 2026
@BYK
Copy link
Member

BYK commented Jan 30, 2026

Maybe it should be a symlink or a pointer to the repo?

Replace duplicate file with symlink pointing to the plugin source at
plugins/sentry-cli/skills/sentry-cli/SKILL.md. Astro resolves symlinks
during build, so dist/ receives the actual file content.

- Remove WELL_KNOWN_PATH from generate-skill.ts (single write location)
- Update workflow to check only the plugin path
- Symlink ensures single source of truth for SKILL.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.

@BYK BYK merged commit b052bbc into main Jan 30, 2026
25 checks passed
@BYK BYK deleted the feat/well-known-skills-discovery branch January 30, 2026 21:23
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.

2 participants