Generate auth.md files and implementation checklists for agent-ready applications.
agentic-auth is for builders creating apps, APIs, services, or SaaS products that may need to support AI agents acting on behalf of users.
It is part of grAIce Tech's work on agentic workflows, governed access, and practical AI systems.
Most applications are designed to authenticate humans. AI agents increasingly need to discover supported auth flows, register with services, receive scoped credentials, and operate within defined permissions.
auth.md is an open protocol from WorkOS that standardizes how agents register with applications. This Claude skill helps new projects consider that requirement early instead of treating it as an afterthought.
cp -r agentic-auth ~/.claude/skills/When you start building a new app, API, or service, the skill asks whether the project should support agentic authentication.
When enabled for a project, the skill can generate:
- An
auth.mdfile for the project root - Suggested scopes and credential type
- Integration guidance for auth endpoints
- Discovery document reminders
- Security notes for tokens, OTPs, replay protection, rate limits, and secrets
The generated auth.md should be served from the production service root, for example:
https://example.com/auth.md
The skill:
- Asks whether the app should support agentic authentication.
- Gathers or infers project details such as service name, domain, description, scopes, flows, and credential type.
- Reads
templates/auth.md.template. - Generates an
auth.mdfile for the project root. - Provides a practical integration checklist.
Reference material lives in references/auth-md-spec.md. Evaluation cases live in evals/.
Status: usable Claude skill with template, protocol reference, and eval cases.
Planned cleanup:
- Keep the generated checklist aligned with the WorkOS auth.md protocol.
- Improve examples for simple apps, APIs, and SaaS products.
- Add clearer guidance for projects that should not support agentic authentication yet.
This skill was inspired by Michael Grinich's MCP Night keynote on auth.md. The auth.md protocol is an open standard created by WorkOS and published under the MIT license at github.com/workos/auth.md.
MIT. Built by Michelle M. Juhanson / grAIce Tech.