Skip to content

docs: fix agent skills index link - #498

Open
mikemikimike wants to merge 3 commits into
stripe:mainfrom
mikemikimike:fix/479-broken-skills-link
Open

docs: fix agent skills index link#498
mikemikimike wants to merge 3 commits into
stripe:mainfrom
mikemikimike:fix/479-broken-skills-link

Conversation

@mikemikimike

@mikemikimike mikemikimike commented Aug 23, 2026

Copy link
Copy Markdown

Summary

Fixes #479.

The Skills README linked to https://docs.stripe.com/.well-known/skills, which is a dead endpoint. Update it to Stripe's canonical machine-readable Skills index: https://docs.stripe.com/.well-known/skills/index.json.

Reproduction and resolution

  • Before this change, the Issue URL returned HTTP 404.
  • After this change, the replacement URL returns HTTP 200 and serves the Skills index.
  • The replacement is an index JSON endpoint by design; it is the discovery endpoint consumed by Skills tooling, rather than an HTML documentation page.

Compatibility and risk

Documentation-only change. No runtime code, API behavior, dependencies, sync logic, or generated files are changed. There are no state, concurrency, atomicity, or migration concerns.

Testing

  • git diff --check — passed.
  • Original endpoint — reproduced HTTP 404.
  • Replacement endpoint — verified HTTP 200 with curl.

Build and unit tests were not run because this PR changes only one Markdown URL and has no executable code path. Automated link-checking could be added separately, but is outside the scope of this Issue.

@cla-assistant

cla-assistant Bot commented Aug 23, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@cla-assistant

cla-assistant Bot commented Aug 23, 2026

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

@mikemikimike

Copy link
Copy Markdown
Author

recheck

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.

Broken README link in stripe/ai/tree/main/skills

1 participant