fix: detect skill/CLI version drift between npm and Claude Code plugin installs - #289

Open
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom
ayushsingh82:fix/274-skill-version-drift-doctor
Open

fix: detect skill/CLI version drift between npm and Claude Code plugin installs#289
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom
ayushsingh82:fix/274-skill-version-drift-doctor

Conversation

@ayushsingh82

@ayushsingh82ayushsingh82 commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Summary

Webcmd ships skills/ through two channels: an npm symlink (always in sync with the running package) and a Claude Code plugin-cache copy that's version-pinned and only refreshed by claude plugin update. Since only the CLI's own version nags on update-check, a user can end up running a newer CLI against older skills with no signal, producing confidently wrong commands.

  • Adds findSkillVersionDrift(): when both channels are present on disk and the plugin-cache version differs from the running CLI, webcmd doctor now reports it with the fix command (claude plugin update webcmd@webcmd). This is item 2 from the issue — the cheapest check that catches the actual broken state.
  • Adds a CONTRIBUTING.md note (item 3): docs:/chore: commits don't cut a release-please version, so a skill fix landed under those prefixes never reaches plugin users even though npm installs pick it up for free.

Item 1 (webcmd update passthrough to claude plugin update) is left for a follow-up since it's more invasive (shelling out to another CLI) and this PR already covers the two lower-risk, high-value pieces.

Fixes#274 (items 2 and 3)

Test plan

  • npx tsc --noEmit
  • Added src/skill-version-drift.test.ts covering: drift reported when both channels present and versions differ, no drift when versions match, no drift when only one channel is installed, and picks the highest of several installed plugin-cache versions.
  • src/doctor.test.ts still passes unchanged (23/23) — the new field doesn't affect existing report assertions.

@ayushsingh82
fix: detect skill/CLI version drift between npm and Claude Code plugi…
9fbd131
…n installs
webcmd ships skills/ through two channels: an npm symlink (always in
sync with the running package) and a Claude Code plugin-cache copy
that's version-pinned and only refreshed by `claude plugin update`.
Since only the CLI's own version nags on update-check, a user can end
up running a newer CLI against older skills with no signal, producing
confidently wrong commands.
Add findSkillVersionDrift(): when both channels are present on disk
and the plugin-cache version differs from the running CLI, webcmd
doctor now reports it with the fix command.
Fixesagentrhq#274 (item 2, the doctor drift check)
@ayushsingh82
docs: note that skill changes need fix:/feat: to reach plugin users
3b97942
Related to agentrhq#274 item 3: docs:/chore: commits don't cut a release-please
version, so a skill edit under those prefixes never reaches the
Claude Code plugin install path even though npm users get it for free
via the symlink.
@github-actions

github-actionsBot commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

🟠 Maintainer review suggested — low confidence

The automated review could not reach a fully supported conclusion.

This review is advisory and does not block merging.

@ayushsingh82

ayushsingh82 commented Aug 11, 2026

Copy link
Copy Markdown
ContributorAuthor

Fixes #274 (items 2 and 3) — @ankitranjan7 adds the doctor drift check plus the CONTRIBUTING.md note. Ready for review.

@ankitranjan7ankitranjan7 mentioned this pull request Aug 20, 2026
Closed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Skill/CLI version drift between npm and Claude Code plugin install paths

1 participant

@ayushsingh82
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
fix: detect skill/CLI version drift between npm and Claude Code plugin installs - #289
Open
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Open
fix: detect skill/CLI version drift between npm and Claude Code plugin installs#289
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Conversation
@ayushsingh82
@ayushsingh82ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
Summary
Webcmd ships skills/ through two channels: an npm symlink (always in sync with the running package) and a Claude Code plugin-cache copy that's version-pinned and only refreshed by claude plugin update. Since only the CLI's own version nags on update-check, a user can end up running a newer CLI against older skills with no signal, producing confidently wrong commands.
  • Adds findSkillVersionDrift(): when both channels are present on disk and the plugin-cache version differs from the running CLI, webcmd doctor now reports it with the fix command (claude plugin update webcmd@webcmd). This is item 2 from the issue — the cheapest check that catches the actual broken state.
  • Adds a CONTRIBUTING.md note (item 3): docs:/chore: commits don't cut a release-please version, so a skill fix landed under those prefixes never reaches plugin users even though npm installs pick it up for free.
Item 1 (webcmd update passthrough to claude plugin update) is left for a follow-up since it's more invasive (shelling out to another CLI) and this PR already covers the two lower-risk, high-value pieces.
Fixes#274 (items 2 and 3)
Test plan
  • npx tsc --noEmit
  •  Added src/skill-version-drift.test.ts covering: drift reported when both channels present and versions differ, no drift when versions match, no drift when only one channel is installed, and picks the highest of several installed plugin-cache versions.
  • src/doctor.test.ts still passes unchanged (23/23) — the new field doesn't affect existing report assertions.
@ayushsingh82
fix: detect skill/CLI version drift between npm and Claude Code plugi…
9fbd131
…n installs
webcmd ships skills/ through two channels: an npm symlink (always in
sync with the running package) and a Claude Code plugin-cache copy
that's version-pinned and only refreshed by `claude plugin update`.
Since only the CLI's own version nags on update-check, a user can end
up running a newer CLI against older skills with no signal, producing
confidently wrong commands.
Add findSkillVersionDrift(): when both channels are present on disk
and the plugin-cache version differs from the running CLI, webcmd
doctor now reports it with the fix command.
Fixesagentrhq#274 (item 2, the doctor drift check)
@ayushsingh82
docs: note that skill changes need fix:/feat: to reach plugin users
3b97942
Related to agentrhq#274 item 3: docs:/chore: commits don't cut a release-please
version, so a skill edit under those prefixes never reaches the
Claude Code plugin install path even though npm users get it for free
via the symlink.
@github-actions
github-actionsBot
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
🟠 Maintainer review suggested — low confidence
The automated review could not reach a fully supported conclusion.
This review is advisory and does not block merging.
@ayushsingh82
ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

ContributorAuthor
Fixes #274 (items 2 and 3) — @ankitranjan7 adds the doctor drift check plus the CONTRIBUTING.md note. Ready for review.
@ankitranjan7ankitranjan7
mentioned this pull request
Aug 20, 2026

Closed

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

Skill/CLI version drift between npm and Claude Code plugin install paths


1 participant

@ayushsingh82

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
fix: detect skill/CLI version drift between npm and Claude Code plugin installs - #289
Open
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Open
fix: detect skill/CLI version drift between npm and Claude Code plugin installs#289
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Conversation
@ayushsingh82
@ayushsingh82ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
Summary
Webcmd ships skills/ through two channels: an npm symlink (always in sync with the running package) and a Claude Code plugin-cache copy that's version-pinned and only refreshed by claude plugin update. Since only the CLI's own version nags on update-check, a user can end up running a newer CLI against older skills with no signal, producing confidently wrong commands.
  • Adds findSkillVersionDrift(): when both channels are present on disk and the plugin-cache version differs from the running CLI, webcmd doctor now reports it with the fix command (claude plugin update webcmd@webcmd). This is item 2 from the issue — the cheapest check that catches the actual broken state.
  • Adds a CONTRIBUTING.md note (item 3): docs:/chore: commits don't cut a release-please version, so a skill fix landed under those prefixes never reaches plugin users even though npm installs pick it up for free.
Item 1 (webcmd update passthrough to claude plugin update) is left for a follow-up since it's more invasive (shelling out to another CLI) and this PR already covers the two lower-risk, high-value pieces.
Fixes#274 (items 2 and 3)
Test plan
  • npx tsc --noEmit
  •  Added src/skill-version-drift.test.ts covering: drift reported when both channels present and versions differ, no drift when versions match, no drift when only one channel is installed, and picks the highest of several installed plugin-cache versions.
  • src/doctor.test.ts still passes unchanged (23/23) — the new field doesn't affect existing report assertions.
@ayushsingh82
fix: detect skill/CLI version drift between npm and Claude Code plugi…
9fbd131
…n installs
webcmd ships skills/ through two channels: an npm symlink (always in
sync with the running package) and a Claude Code plugin-cache copy
that's version-pinned and only refreshed by `claude plugin update`.
Since only the CLI's own version nags on update-check, a user can end
up running a newer CLI against older skills with no signal, producing
confidently wrong commands.
Add findSkillVersionDrift(): when both channels are present on disk
and the plugin-cache version differs from the running CLI, webcmd
doctor now reports it with the fix command.
Fixesagentrhq#274 (item 2, the doctor drift check)
@ayushsingh82
docs: note that skill changes need fix:/feat: to reach plugin users
3b97942
Related to agentrhq#274 item 3: docs:/chore: commits don't cut a release-please
version, so a skill edit under those prefixes never reaches the
Claude Code plugin install path even though npm users get it for free
via the symlink.
@github-actions
github-actionsBot
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
🟠 Maintainer review suggested — low confidence
The automated review could not reach a fully supported conclusion.
This review is advisory and does not block merging.
@ayushsingh82
ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

ContributorAuthor
Fixes #274 (items 2 and 3) — @ankitranjan7 adds the doctor drift check plus the CONTRIBUTING.md note. Ready for review.
@ankitranjan7ankitranjan7
mentioned this pull request
Aug 20, 2026

Closed

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

Skill/CLI version drift between npm and Claude Code plugin install paths


1 participant

@ayushsingh82

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
fix: detect skill/CLI version drift between npm and Claude Code plugin installs - #289
Open
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Open
fix: detect skill/CLI version drift between npm and Claude Code plugin installs#289
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Conversation
@ayushsingh82
@ayushsingh82ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
Summary
Webcmd ships skills/ through two channels: an npm symlink (always in sync with the running package) and a Claude Code plugin-cache copy that's version-pinned and only refreshed by claude plugin update. Since only the CLI's own version nags on update-check, a user can end up running a newer CLI against older skills with no signal, producing confidently wrong commands.
  • Adds findSkillVersionDrift(): when both channels are present on disk and the plugin-cache version differs from the running CLI, webcmd doctor now reports it with the fix command (claude plugin update webcmd@webcmd). This is item 2 from the issue — the cheapest check that catches the actual broken state.
  • Adds a CONTRIBUTING.md note (item 3): docs:/chore: commits don't cut a release-please version, so a skill fix landed under those prefixes never reaches plugin users even though npm installs pick it up for free.
Item 1 (webcmd update passthrough to claude plugin update) is left for a follow-up since it's more invasive (shelling out to another CLI) and this PR already covers the two lower-risk, high-value pieces.
Fixes#274 (items 2 and 3)
Test plan
  • npx tsc --noEmit
  •  Added src/skill-version-drift.test.ts covering: drift reported when both channels present and versions differ, no drift when versions match, no drift when only one channel is installed, and picks the highest of several installed plugin-cache versions.
  • src/doctor.test.ts still passes unchanged (23/23) — the new field doesn't affect existing report assertions.
@ayushsingh82
fix: detect skill/CLI version drift between npm and Claude Code plugi…
9fbd131
…n installs
webcmd ships skills/ through two channels: an npm symlink (always in
sync with the running package) and a Claude Code plugin-cache copy
that's version-pinned and only refreshed by `claude plugin update`.
Since only the CLI's own version nags on update-check, a user can end
up running a newer CLI against older skills with no signal, producing
confidently wrong commands.
Add findSkillVersionDrift(): when both channels are present on disk
and the plugin-cache version differs from the running CLI, webcmd
doctor now reports it with the fix command.
Fixesagentrhq#274 (item 2, the doctor drift check)
@ayushsingh82
docs: note that skill changes need fix:/feat: to reach plugin users
3b97942
Related to agentrhq#274 item 3: docs:/chore: commits don't cut a release-please
version, so a skill edit under those prefixes never reaches the
Claude Code plugin install path even though npm users get it for free
via the symlink.
@github-actions
github-actionsBot
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
🟠 Maintainer review suggested — low confidence
The automated review could not reach a fully supported conclusion.
This review is advisory and does not block merging.
@ayushsingh82
ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

ContributorAuthor
Fixes #274 (items 2 and 3) — @ankitranjan7 adds the doctor drift check plus the CONTRIBUTING.md note. Ready for review.
@ankitranjan7ankitranjan7
mentioned this pull request
Aug 20, 2026

Closed

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

Skill/CLI version drift between npm and Claude Code plugin install paths


1 participant

@ayushsingh82

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
fix: detect skill/CLI version drift between npm and Claude Code plugin installs - #289
Open
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Open
fix: detect skill/CLI version drift between npm and Claude Code plugin installs#289
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Conversation
@ayushsingh82
@ayushsingh82ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
Summary
Webcmd ships skills/ through two channels: an npm symlink (always in sync with the running package) and a Claude Code plugin-cache copy that's version-pinned and only refreshed by claude plugin update. Since only the CLI's own version nags on update-check, a user can end up running a newer CLI against older skills with no signal, producing confidently wrong commands.
  • Adds findSkillVersionDrift(): when both channels are present on disk and the plugin-cache version differs from the running CLI, webcmd doctor now reports it with the fix command (claude plugin update webcmd@webcmd). This is item 2 from the issue — the cheapest check that catches the actual broken state.
  • Adds a CONTRIBUTING.md note (item 3): docs:/chore: commits don't cut a release-please version, so a skill fix landed under those prefixes never reaches plugin users even though npm installs pick it up for free.
Item 1 (webcmd update passthrough to claude plugin update) is left for a follow-up since it's more invasive (shelling out to another CLI) and this PR already covers the two lower-risk, high-value pieces.
Fixes#274 (items 2 and 3)
Test plan
  • npx tsc --noEmit
  •  Added src/skill-version-drift.test.ts covering: drift reported when both channels present and versions differ, no drift when versions match, no drift when only one channel is installed, and picks the highest of several installed plugin-cache versions.
  • src/doctor.test.ts still passes unchanged (23/23) — the new field doesn't affect existing report assertions.
@ayushsingh82
fix: detect skill/CLI version drift between npm and Claude Code plugi…
9fbd131
…n installs
webcmd ships skills/ through two channels: an npm symlink (always in
sync with the running package) and a Claude Code plugin-cache copy
that's version-pinned and only refreshed by `claude plugin update`.
Since only the CLI's own version nags on update-check, a user can end
up running a newer CLI against older skills with no signal, producing
confidently wrong commands.
Add findSkillVersionDrift(): when both channels are present on disk
and the plugin-cache version differs from the running CLI, webcmd
doctor now reports it with the fix command.
Fixesagentrhq#274 (item 2, the doctor drift check)
@ayushsingh82
docs: note that skill changes need fix:/feat: to reach plugin users
3b97942
Related to agentrhq#274 item 3: docs:/chore: commits don't cut a release-please
version, so a skill edit under those prefixes never reaches the
Claude Code plugin install path even though npm users get it for free
via the symlink.
@github-actions
github-actionsBot
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
🟠 Maintainer review suggested — low confidence
The automated review could not reach a fully supported conclusion.
This review is advisory and does not block merging.
@ayushsingh82
ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

ContributorAuthor
Fixes #274 (items 2 and 3) — @ankitranjan7 adds the doctor drift check plus the CONTRIBUTING.md note. Ready for review.
@ankitranjan7ankitranjan7
mentioned this pull request
Aug 20, 2026

Closed

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

Skill/CLI version drift between npm and Claude Code plugin install paths


1 participant

@ayushsingh82

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
fix: detect skill/CLI version drift between npm and Claude Code plugin installs - #289
Open
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Open
fix: detect skill/CLI version drift between npm and Claude Code plugin installs#289
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Conversation
@ayushsingh82
@ayushsingh82ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
Summary
Webcmd ships skills/ through two channels: an npm symlink (always in sync with the running package) and a Claude Code plugin-cache copy that's version-pinned and only refreshed by claude plugin update. Since only the CLI's own version nags on update-check, a user can end up running a newer CLI against older skills with no signal, producing confidently wrong commands.
  • Adds findSkillVersionDrift(): when both channels are present on disk and the plugin-cache version differs from the running CLI, webcmd doctor now reports it with the fix command (claude plugin update webcmd@webcmd). This is item 2 from the issue — the cheapest check that catches the actual broken state.
  • Adds a CONTRIBUTING.md note (item 3): docs:/chore: commits don't cut a release-please version, so a skill fix landed under those prefixes never reaches plugin users even though npm installs pick it up for free.
Item 1 (webcmd update passthrough to claude plugin update) is left for a follow-up since it's more invasive (shelling out to another CLI) and this PR already covers the two lower-risk, high-value pieces.
Fixes#274 (items 2 and 3)
Test plan
  • npx tsc --noEmit
  •  Added src/skill-version-drift.test.ts covering: drift reported when both channels present and versions differ, no drift when versions match, no drift when only one channel is installed, and picks the highest of several installed plugin-cache versions.
  • src/doctor.test.ts still passes unchanged (23/23) — the new field doesn't affect existing report assertions.
@ayushsingh82
fix: detect skill/CLI version drift between npm and Claude Code plugi…
9fbd131
…n installs
webcmd ships skills/ through two channels: an npm symlink (always in
sync with the running package) and a Claude Code plugin-cache copy
that's version-pinned and only refreshed by `claude plugin update`.
Since only the CLI's own version nags on update-check, a user can end
up running a newer CLI against older skills with no signal, producing
confidently wrong commands.
Add findSkillVersionDrift(): when both channels are present on disk
and the plugin-cache version differs from the running CLI, webcmd
doctor now reports it with the fix command.
Fixesagentrhq#274 (item 2, the doctor drift check)
@ayushsingh82
docs: note that skill changes need fix:/feat: to reach plugin users
3b97942
Related to agentrhq#274 item 3: docs:/chore: commits don't cut a release-please
version, so a skill edit under those prefixes never reaches the
Claude Code plugin install path even though npm users get it for free
via the symlink.
@github-actions
github-actionsBot
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
🟠 Maintainer review suggested — low confidence
The automated review could not reach a fully supported conclusion.
This review is advisory and does not block merging.
@ayushsingh82
ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

ContributorAuthor
Fixes #274 (items 2 and 3) — @ankitranjan7 adds the doctor drift check plus the CONTRIBUTING.md note. Ready for review.
@ankitranjan7ankitranjan7
mentioned this pull request
Aug 20, 2026

Closed

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

Skill/CLI version drift between npm and Claude Code plugin install paths


1 participant

@ayushsingh82

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
fix: detect skill/CLI version drift between npm and Claude Code plugin installs - #289
Open
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Open
fix: detect skill/CLI version drift between npm and Claude Code plugin installs#289
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Conversation
@ayushsingh82
@ayushsingh82ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
Summary
Webcmd ships skills/ through two channels: an npm symlink (always in sync with the running package) and a Claude Code plugin-cache copy that's version-pinned and only refreshed by claude plugin update. Since only the CLI's own version nags on update-check, a user can end up running a newer CLI against older skills with no signal, producing confidently wrong commands.
  • Adds findSkillVersionDrift(): when both channels are present on disk and the plugin-cache version differs from the running CLI, webcmd doctor now reports it with the fix command (claude plugin update webcmd@webcmd). This is item 2 from the issue — the cheapest check that catches the actual broken state.
  • Adds a CONTRIBUTING.md note (item 3): docs:/chore: commits don't cut a release-please version, so a skill fix landed under those prefixes never reaches plugin users even though npm installs pick it up for free.
Item 1 (webcmd update passthrough to claude plugin update) is left for a follow-up since it's more invasive (shelling out to another CLI) and this PR already covers the two lower-risk, high-value pieces.
Fixes#274 (items 2 and 3)
Test plan
  • npx tsc --noEmit
  •  Added src/skill-version-drift.test.ts covering: drift reported when both channels present and versions differ, no drift when versions match, no drift when only one channel is installed, and picks the highest of several installed plugin-cache versions.
  • src/doctor.test.ts still passes unchanged (23/23) — the new field doesn't affect existing report assertions.
@ayushsingh82
fix: detect skill/CLI version drift between npm and Claude Code plugi…
9fbd131
…n installs
webcmd ships skills/ through two channels: an npm symlink (always in
sync with the running package) and a Claude Code plugin-cache copy
that's version-pinned and only refreshed by `claude plugin update`.
Since only the CLI's own version nags on update-check, a user can end
up running a newer CLI against older skills with no signal, producing
confidently wrong commands.
Add findSkillVersionDrift(): when both channels are present on disk
and the plugin-cache version differs from the running CLI, webcmd
doctor now reports it with the fix command.
Fixesagentrhq#274 (item 2, the doctor drift check)
@ayushsingh82
docs: note that skill changes need fix:/feat: to reach plugin users
3b97942
Related to agentrhq#274 item 3: docs:/chore: commits don't cut a release-please
version, so a skill edit under those prefixes never reaches the
Claude Code plugin install path even though npm users get it for free
via the symlink.
@github-actions
github-actionsBot
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
🟠 Maintainer review suggested — low confidence
The automated review could not reach a fully supported conclusion.
This review is advisory and does not block merging.
@ayushsingh82
ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

ContributorAuthor
Fixes #274 (items 2 and 3) — @ankitranjan7 adds the doctor drift check plus the CONTRIBUTING.md note. Ready for review.
@ankitranjan7ankitranjan7
mentioned this pull request
Aug 20, 2026

Closed

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

Skill/CLI version drift between npm and Claude Code plugin install paths


1 participant

@ayushsingh82

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
fix: detect skill/CLI version drift between npm and Claude Code plugin installs - #289
Open
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Open
fix: detect skill/CLI version drift between npm and Claude Code plugin installs#289
ayushsingh82 wants to merge 2 commits into
agentrhq:mainfrom 
ayushsingh82:fix/274-skill-version-drift-doctor
Conversation
@ayushsingh82
@ayushsingh82ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
Summary
Webcmd ships skills/ through two channels: an npm symlink (always in sync with the running package) and a Claude Code plugin-cache copy that's version-pinned and only refreshed by claude plugin update. Since only the CLI's own version nags on update-check, a user can end up running a newer CLI against older skills with no signal, producing confidently wrong commands.
  • Adds findSkillVersionDrift(): when both channels are present on disk and the plugin-cache version differs from the running CLI, webcmd doctor now reports it with the fix command (claude plugin update webcmd@webcmd). This is item 2 from the issue — the cheapest check that catches the actual broken state.
  • Adds a CONTRIBUTING.md note (item 3): docs:/chore: commits don't cut a release-please version, so a skill fix landed under those prefixes never reaches plugin users even though npm installs pick it up for free.
Item 1 (webcmd update passthrough to claude plugin update) is left for a follow-up since it's more invasive (shelling out to another CLI) and this PR already covers the two lower-risk, high-value pieces.
Fixes#274 (items 2 and 3)
Test plan
  • npx tsc --noEmit
  •  Added src/skill-version-drift.test.ts covering: drift reported when both channels present and versions differ, no drift when versions match, no drift when only one channel is installed, and picks the highest of several installed plugin-cache versions.
  • src/doctor.test.ts still passes unchanged (23/23) — the new field doesn't affect existing report assertions.
@ayushsingh82
fix: detect skill/CLI version drift between npm and Claude Code plugi…
9fbd131
…n installs
webcmd ships skills/ through two channels: an npm symlink (always in
sync with the running package) and a Claude Code plugin-cache copy
that's version-pinned and only refreshed by `claude plugin update`.
Since only the CLI's own version nags on update-check, a user can end
up running a newer CLI against older skills with no signal, producing
confidently wrong commands.
Add findSkillVersionDrift(): when both channels are present on disk
and the plugin-cache version differs from the running CLI, webcmd
doctor now reports it with the fix command.
Fixesagentrhq#274 (item 2, the doctor drift check)
@ayushsingh82
docs: note that skill changes need fix:/feat: to reach plugin users
3b97942
Related to agentrhq#274 item 3: docs:/chore: commits don't cut a release-please
version, so a skill edit under those prefixes never reaches the
Claude Code plugin install path even though npm users get it for free
via the symlink.
@github-actions
github-actionsBot
commented
Aug 11, 2026

Copy link


Copy Markdown

Contributor
🟠 Maintainer review suggested — low confidence
The automated review could not reach a fully supported conclusion.
This review is advisory and does not block merging.
@ayushsingh82
ayushsingh82
commented
Aug 11, 2026

Copy link


Copy Markdown

ContributorAuthor
Fixes #274 (items 2 and 3) — @ankitranjan7 adds the doctor drift check plus the CONTRIBUTING.md note. Ready for review.
@ankitranjan7ankitranjan7
mentioned this pull request
Aug 20, 2026

Closed

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

Skill/CLI version drift between npm and Claude Code plugin install paths


1 participant

@ayushsingh82