WorkOS Skill Router
0The WorkOS Skill Router helps in routing user requests to the correct reference files based on decision rules. It's designed for developers integrating WorkOS widgets and API calls.
000Updated 2mo ago
Integration
Quick InstallView Source
$ npx skills add https://github.com/workos/skills --skill workosOverview
About This Skill
The WorkOS Skill Router is a decision-based routing skill that intelligently directs AI agents to the correct reference documentation based on user requests. It covers 40+ reference files spanning AuthKit setup across multiple frameworks, backend SDK installation for nine languages, feature implementations like SSO and RBAC, migration guides from competing platforms, and API references. Developers integrating WorkOS authentication and identity solutions benefit from automatic reference selection, eliminating the need to manually install individual documentation files. The router works with Claude Code, Cursor, Codex, Goose, and any agent supporting the skills.sh format.
How to Use
Install via npx and follow the routing instructions in the reference files.
Use Cases
Routing user queries to appropriate WorkOS documentation
Implementing user management with WorkOS widgets
Integrating authentication features using WorkOS APIs
Tags
Setup & Installation
Quick Install
Terminal
$ npx skills add https://github.com/workos/skills --skill workosAlternative Install (Git Clone)
git clone https://github.com/workos/skillsRequirements
- Claude Code or compatible AI agent
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
Route the following user request to the appropriate WorkOS reference file or API endpoint using the Skill Router. Decision criteria: [REQUEST_TYPE], [USER_INTENT], [WORKOS_SERVICE]. Reference files: [FILE_1], [FILE_2], [FILE_3]. Return the correct file path or API endpoint with a brief explanation. Request: '[USER_REQUEST]'
Example Output
**Routing Result:** **File/API Endpoint:** `/workos/v1/authentication/mfa` **Explanation:** The request involves a user attempting to enable Multi-Factor Authentication (MFA) for their WorkOS-integrated application. This matches the `authentication/mfa` endpoint, which handles MFA configuration and management. The router directs the request to the MFA reference file for further processing. **Next Steps:** - Verify the user has the necessary permissions. - Check if the MFA method (e.g., SMS, authenticator app) is supported. - Proceed with the MFA setup workflow.
Find the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan