Skip to content

fix: broaden skill description for more reliable triggering#10

Merged
nicknisi merged 2 commits intomainfrom
nicknisi/next-skills-improvements
Mar 17, 2026
Merged

fix: broaden skill description for more reliable triggering#10
nicknisi merged 2 commits intomainfrom
nicknisi/next-skills-improvements

Conversation

@nicknisi
Copy link
Member

@nicknisi nicknisi commented Mar 16, 2026

Summary

The skill description ("Identify which WorkOS reference to load") was too narrow and meta-sounding, causing Claude to skip the workos skill for concrete implementation questions (e.g., "fix the device auth flow to return org-scoped tokens").

  • Reframes description with "Use when the user is implementing, debugging, or asking about WorkOS in any way"
  • Enumerates 40+ specific keywords: device authorization, access tokens, organization-scoped tokens, sessions, SAML, SCIM, FGA, webhooks, user management, migrations, etc.
  • Keeps the "routes to the right reference and gotchas" suffix so the model still knows what the skill does internally

Test plan

  • Install plugin and verify skill triggers on broad WorkOS questions (e.g., "how do I scope tokens to an org")
  • Verify skill still triggers on existing keywords (SSO, AuthKit, RBAC, etc.)
  • pnpm eval -- --dry-run loads all cases without error

getSignInUrl() internally sets a PKCE cookie via cookies(), which
cannot be called in Server Components in Next.js 15+/16. Add explicit
warning in Step 8 and new Error Recovery subsection guiding the agent
to use Server Actions or Route Handlers instead.
The previous description ("Identify which WorkOS reference to load")
was too narrow and meta-sounding, causing Claude to skip the skill
for concrete implementation questions. New description uses action
framing and enumerates 40+ keywords covering all WorkOS features.
@nicknisi nicknisi changed the title fix: add Server Component cookie safety warning to Next.js skill fix: broaden skill description for more reliable triggering Mar 17, 2026
@nicknisi nicknisi merged commit 4340e7e into main Mar 17, 2026
2 checks passed
@nicknisi nicknisi deleted the nicknisi/next-skills-improvements branch March 17, 2026 22:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant