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.
