DriftaBot Registry Skill#

DriftaBot Registry ( https://github.com/DriftaBot/registry) is a public registry that:

• Tracks 59+ API providers (Stripe, GitHub, Twilio, Slack, Shopify, and many more)
• Crawls specs daily from each provider's canonical GitHub repository
• Generates markdown drift reports when breaking changes are detected

When to use this skill#

• User asks "did X API change?", "what broke in Y's API?", "show me drift for Z"
• User wants to know which providers are tracked in the registry
• User asks about current API spec versions or types (OpenAPI, GraphQL, gRPC)

How to query the registry#

Base URL: https://raw.githubusercontent.com/DriftaBot/registry/main

1. List all providers#

Fetch {BASE}/provider.companies.yaml and parse the YAML. Each entry has: name (slug), display_name, specs[].type, specs[].repo.

2. Get a drift report for a provider#

Fetch {BASE}/drifts/{org}/{repo}/result.md

• Find org/repo from the provider's specs[].repo field in provider.companies.yaml
• Example: stripe → repo stripe/openapi → fetch drifts/stripe/openapi/result.md
• If the file returns 404 or empty, no breaking changes were detected for that provider.

3. Get the current spec file#

Fetch {BASE}/companies/providers/{name}/{type}/{filename}

• Example: companies/providers/stripe/openapi/stripe.openapi.json

Example queries and responses#

"Did Stripe's API break anything?" → Fetch drifts/stripe/openapi/result.md and summarize the breaking changes.

"What API providers are tracked?" → Fetch provider.companies.yaml, list all company names and their spec types.

"What type of spec does Shopify use?" → Find shopify in provider.companies.yaml, return specs[].type (graphql).

Tool usage#

Use the web tool (or bash with curl) to fetch URLs. Parse YAML with available tools. Always look up the repo from provider.companies.yaml before constructing drift URLs.