Skip to content

feat: complete WorkOS skill install + refresh loop with doctor --fix #130

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nicknisi merged 10 commits into from
Apr 26, 2026
Merged

feat: complete WorkOS skill install + refresh loop with doctor --fix #130

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
d6551bf
feat: surface WorkOS skill auto-install and track version
nicknisi Apr 24, 2026
3476e85
feat(doctor): warn when WorkOS skills are outdated
nicknisi Apr 24, 2026
ae70685
feat(install): recursive prune-replace skill copy with rollback
nicknisi Apr 26, 2026
e49149e
feat(doctor): add --fix to refresh stale WorkOS skills
nicknisi Apr 26, 2026
f0e4f9b
chore(deps): bump @workos/skills from 0.2.4 to 0.4.0
nicknisi Apr 26, 2026
147a8e8
chore: formatting
nicknisi Apr 26, 2026
0a7b963
fix: address PR review feedback (CodeRabbit / Greptile / Codex)
nicknisi Apr 26, 2026
7dc8deb
fix: address remaining CodeRabbit findings on PR #130
nicknisi Apr 26, 2026
f4a9fcd
chore: oxfmt format
nicknisi Apr 26, 2026
cc6ffe7
docs(readme): mention auth-login skill hook and doctor --fix
nicknisi Apr 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ Commands:
doctor Diagnose WorkOS integration issues
skills Manage WorkOS skills for coding agents (install, uninstall, list)

Skills are automatically installed to detected coding agents when you run `workos install`. Use `workos skills list` to check status.
Skills auto-install to detected coding agents on `workos install` and `workos auth login`. Use `workos skills list` to check status, `workos doctor` to detect stale skills, or `workos doctor --fix` to refresh them in place (constrained to `workos/` and `workos-widgets/`).

Resource Management:
organization (org) Manage organizations
Expand Down
2 changes: 1 addition & 1 deletion package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@
"@clack/prompts": "1.0.1",
"@napi-rs/keyring": "^1.2.0",
"@workos-inc/node": "^8.7.0",
"@workos/skills": "0.2.4",
"@workos/skills": "0.4.0",
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot Apr 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🌐 Web query:

For npm package @workos/skills` version 0.4.0, confirm:

  1. it still exports getSkillsDir,
  2. its package layout still supports resolving package.json by walking up three directories from getSkillsDir() result,
  3. there were no breaking changes from 0.2.4 that affect CLI embedding/install workflows.
    Please include links to changelog/release notes or package source.`

💡 Result:

No evidence found for npm package @workos/skills version 0.4.0 existing as of 2026-04-26. Latest documented version is 0.2.4 (https://github.com/workos/skills/releases/tag/v0.2.4), with later releases up to 0.3.0 mentioned in PRs but no 0.4.0. Repo README and docs explicitly list getSkillsDir as exported in current versions (https://github.com/workos/skills), described as returning absolute path to the skills/ directory containing skill folders like workos/. 1) Cannot confirm for non-existent v0.4.0; exported in latest available (0.2.4+). 2) Cannot confirm layout for v0.4.0. Repo structure shows skills/ under repo root (https://github.com/workos/skills/blob/main/CLAUDE.md); when installed via npm, node_modules/@workos/skills/package.json is at module root. Typical path resolution from skills/ dir (getSkillsDir) would be .. (to @workos/skills) -> ../../ (to project root) -> ../../.. (outside), but "three directories up" likely reaches project root package.json if skills/ is nested as plugins/workos/skills/ per CLAUDE.md. No breaking layout changes evident. 3) From 0.2.4 changelog: only bug fix for Next.js AuthKit skill (no CLI/embedding impact). Earlier releases (0.2.1-0.2.3) are minor bug fixes/package tweaks (https://github.com/workos/skills/releases). No breaking changes affecting CLI embedding/install workflows identified. Sources: GitHub repo (1,4,6), releases (2,47-49), libraries.io (3), PRs (50,51). Cannot verify v0.4.0 specifics due to lack of evidence.

Citations:

@workos/skills@0.4.0 does not exist; update to latest available version (0.2.4).

The web search confirmed that @workos/skills version 0.4.0 has not been released. The latest documented version is 0.2.4 (https://github.com/workos/skills/releases/tag/v0.2.4). Versions 0.3.0 have been mentioned in PRs but lack official releases. This dependency will fail at install time. Update the pin to an actual released version such as 0.2.4 or 0.3.0 (if officially available in your npm registry).

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@package.json` at line 54, The package.json dependency pin for
"@workos/skills": "0.4.0" is invalid and will fail install; update that
dependency entry to a released version (for example "0.2.4") by replacing the
current version string for the "@workos/skills" key with the actual released
version (e.g., change "@workos/skills": "0.4.0" to "@workos/skills": "0.2.4")
and run install to verify.

"chalk": "^5.6.2",
"diff": "^8.0.3",
"fast-glob": "^3.3.3",
Expand Down
10 changes: 5 additions & 5 deletions pnpm-lock.yaml
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

5 changes: 5 additions & 0 deletions src/bin.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -343,6 +343,11 @@ yargs(rawArgs)
default: false,
description: 'Copy report to clipboard',
},
fix: {
type: 'boolean',
default: false,
description: 'Auto-update stale WorkOS skills (writes to <agent>/skills/workos/ and workos-widgets/ only)',
},
}),
async (argv) => {
const { handleDoctor } = await import('./commands/doctor.js');
Expand Down
2 changes: 2 additions & 0 deletions src/commands/doctor.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ interface DoctorArgs {
installDir?: string;
json?: boolean;
copy?: boolean;
fix?: boolean;
}

export async function handleDoctor(argv: ArgumentsCamelCase<DoctorArgs>): Promise<void> {
Expand All @@ -19,6 +20,7 @@ export async function handleDoctor(argv: ArgumentsCamelCase<DoctorArgs>): Promis
skipAi: argv.skipAi ?? false,
json: argv.json ?? false,
copy: argv.copy ?? false,
fix: argv.fix ?? false,
};

try {
Expand Down
Loading
Loading