Name: tapps-upgrade
Author: wtthornton

Imported from wtthornton/agentforge-workflow-plugin (.tapps-mcp/backups/2026-08-03-213426/.claude/skills/tapps-upgrade/SKILL.md). Install upstream with npx skills add wtthornton/agentforge-workflow-plugin --skill tapps-upgrade. Copyright stays with the author.

Upgrade tapps-mcp / docs-mcp end-to-end. The user's request to upgrade is standing authorization for the full pipeline — do NOT pause mid-flow.

Pick an install source from the prompt:

Local checkout (--from-checkout <path> or user mentions a local clone): uv tool install --reinstall --from <path>/packages/tapps-mcp tapps-mcp and the same for docs-mcp.
Git tag (--from-tag vX.Y.Z): uv tool install --reinstall "git+https://github.com/wtthornton/tapps-mcp.git@vX.Y.Z#subdirectory=packages/tapps-mcp" tapps-mcp and the same for docs-mcp.
If neither is specified, ASK once which to use.

Steps:

Reinstall global CLIs. Run both uv tool install --reinstall ... commands. Verify: uv tool list | grep -E '(tapps-mcp|docs-mcp)' — both must show the same version.
Restart MCP servers. The running processes still hold old code. Tell the user to exit/reopen (or /mcp reconnect), then re-invoke this skill. Stop here on the first invocation.
Verify new version is live. Call mcp__nlt-build__tapps_session_start(force=true). Confirm server.version matches target and diagnostics.install_drift.drift_detected == false. If drift persists, the server wasn't restarted — go back to step 2.
Dry-run the scaffolding refresh. Run tapps-mcp upgrade --dry-run. Review the diff for AGENTS.md, CLAUDE.md, .claude/hooks/, .claude/rules/, .claude/agents/, .claude/skills/, .mcp.json. Note mcp_bundle / mcp_bundle_note in the result — custom trimmed Cursor sets are preserved; explicit yaml wins. The smart-merge preserves customizations in non-canonical sections; canonical sections are replaced wholesale. Pause if a customized canonical section will be overwritten.
Apply the upgrade. Run tapps-mcp upgrade (writes timestamped backup to .tapps-mcp/backups/<ts>/).
Verify. Run tapps-mcp doctor AND mcp__nlt-build__tapps_checklist(task_type="upgrade"). Surface any problems — do not declare done on a failure. Doctor NLT row shows eager (Claude) vs listed (Cursor).
Report. One-line summary: Upgraded: tapps-mcp X.Y.Z, docs-mcp X.Y.Z. Scaffolding: N files. Bundle: <mcp_bundle>. Doctor: OK. Checklist: complete. Backup: .tapps-mcp/backups/<ts>/.

Bundle opt-down after upgrade: tapps-mcp mcp-bundle set developer|minimal|… then reload MCP (do not hand-edit mcp.json and expect upgrade to keep a yaml=full mismatch).

Rollback (only if step 5/6 broke something): tapps-mcp rollback restores from the most recent backup. Do NOT roll back "to be safe" after a clean run.

Do NOT:

Publish to PyPI / npm — tapps-mcp is local-install only.
Bump versions in the tapps-mcp dev repo itself — separate workflow.
Touch tapps-brain — separate Docker service with its own release flow.
Add tapps-brain as a top-level .mcp.json entry — it's bridge-only via tapps-mcp's BrainBridge.

Install tapps-upgrade and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "wtthornton-agentforge-workflow-plugin-tapps-upgrade", "kind": "skill", "name": "tapps-upgrade", "description": "Upgrade tapps-mcp / docs-mcp in this project to the latest version. Reinstalls global CLIs, restarts the MCP servers, refreshes scaffolding via `tapps-mcp upgrade` (dry-run preview + timestamped backup), and verifies via doctor + checklist. Use when a new tapps-mcp or docs-mcp version is available and the project scaffolding needs to be refreshed.", "publisher": "wtthornton", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Upgrade tapps-mcp / docs-mcp in this project to the latest version. Reinstalls global CLIs, restarts the MCP servers, refreshes scaffolding via `tapps-mcp upgrade` (dry-run preview + timestamped backup), and verifies via doctor + checklist. Use when a new tapps-mcp or docs-mcp version is available and the project scaffolding needs to be refreshed." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/wtthornton/agentforge-workflow-plugin", "path": ".tapps-mcp/backups/2026-08-03-213426/.claude/skills/tapps-upgrade/SKILL.md", "ref": "c812a840c18ab9c22b4b7b54dfbe0cec22316939", "url": "https://github.com/wtthornton/agentforge-workflow-plugin/blob/c812a840c18ab9c22b4b7b54dfbe0cec22316939/.tapps-mcp/backups/2026-08-03-213426/.claude/skills/tapps-upgrade/SKILL.md", "key": "wtthornton/agentforge-workflow-plugin/.tapps-mcp/backups/2026-08-03-213426/.claude/skills/tapps-upgrade/SKILL.md" }, "allowed_tools": [ "Bash", "mcp__nlt-build__tapps_session_start", "mcp__nlt-setup__tapps_doctor", "mcp__nlt-build__tapps_checklist" ] }, "instructions": "Upgrade tapps-mcp / docs-mcp end-to-end. The user's request to upgrade is standing authorization for the full pipeline — do NOT pause mid-flow.\n\n**Pick an install source from the prompt:**\n\n- Local checkout (`--from-checkout <path>` or user mentions a local clone):\n `uv tool install --reinstall --from <path>/packages/tapps-mcp tapps-mcp`\n and the same for `docs-mcp`.\n- Git tag (`--from-tag vX.Y.Z`):\n `uv tool install --reinstall \"git+https://github.com/wtthornton/tapps-mcp.git@vX.Y.Z#subdirectory=packages/tapps-mcp\" tapps-mcp`\n and the same for `docs-mcp`.\n- If neither is specified, ASK on", "cost": { "context_tokens": 722 } }

tapps-upgrade

About

Install tapps-upgrade and it becomes one more candidate the router can pick - when it fits.

Use it

Manifest

Reviews