chore(skills): fix broken tool names, commands and paths across agent skills

Merged
KI
2d ago
+125-220

What

A review of every skill and agent command in the repo, fixing what would fail or mislead an agent. Paradev plugin skill fixes are in #9257, next to the CLI change they depend on.

Broken

  • sentry (debug-with-sentry, find-in-sentry): allowed-tools named get_issue_details, get_event_stacktrace, search_events and others as direct tools. The server lists 14 tools; the rest are catalog tools reached through search_sentry_tools + execute_sentry_tool. search_events is search_errors. (Tool list from superset mcp tools --plugin sentry.)
  • github ci-triage: api.githubcopilot.com/mcp/ serves only the default toolsets, which leave out actions (job logs, re-runs). plugin.json now sends X-MCP-Toolsets: context,repos,issues,pull_requests,users,actions; the proxy forwards mcp.headers (resolve-target.ts).
  • /task, /task-run: used v1 MCP tools (create_task, list_members, list_devices, create_workspace, start_agent_session) that were removed with the v1 server. Now tasks_create, organization_members_list, hosts_list, projects_list, workspaces_create (whose agents field starts the agent).
  • pr/create-pr: deleted. It describes the Create PR button attaching pr-context.md; that flow and buildPRContext were removed (#6461).
  • create-pr, create-plan: bun run lint:check-node-imports exists in no package.json. create-plan pointed at src/shared/ipc-channels.ts and other removed desktop files (IPC is tRPC routers now) and at apps/web/plans, apps/api/plans (don't exist).
  • mobile-sim-verification: flows/sign-in.yml was deleted (#8087); the egress log is .tmp/eas-dev/egress.log.
  • incident-triage and the incidents runbook: superset doctor is a skill, not a CLI command.
  • dev-doctor: Sentry org is superset-sh, not paradev.
  • ci-check: root bun test runs every suite in one process; CI runs bun run test (turbo).
  • AGENTS.md examples: ws create --project needs --name; agents create and terminals read need --local, since they default to the cloud on cloud accounts.

Outdated / minor

  • peec: list PLANNED (customer-written actions); create_actions needs kind.
  • superhuman: through Paradev, calls also take superset_account when there are several connections.
  • stripe: the MCP server can't close a dispute; evidence goes through evidence + submit: true.
  • circleback: SearchMeetings has no sort, and a profiles filter means every profile attended.
  • linear duplicate-sweep: name duplicateOf / relatedTo on save_issue.
  • notion: drop the title-vs-body search advice (notion-search can't); allow notion-list-page-backlinks.
  • granola: mention switch_workspace.
  • superset-settings, cdp-verification: app home is ~/.paradev (legacy ~/.superset).
  • create-pr, create-plan gain frontmatter descriptions. deslop follows the AGENTS.md comment rule. draft doesn't hard-code the mcp__linear-server__ prefix.

Publishes github 1.0.4, linear 1.5.6, notion 1.0.6, sentry 1.0.3, granola 1.0.3, circleback 1.0.3, stripe 1.0.3, superhuman 1.0.3, peec 1.0.1.

Verified

  • bun run check:plugins: clean. packages/shared plugin tests: 23 pass. bun run lint:fix: clean.
  • I checked tool names against live servers: Sentry (through the proxy), Peec list_actions/create_actions, Linear save_issue. MCP tool names for /task against packages/mcp/src/tools/.
  • Not verified end to end: the GitHub actions toolset (github isn't installed on my account), and the Granola and Sazabi argument details (taken from vendor docs; Sazabi's skills left unchanged).

Not changed

  • apps/mobile/scripts/e2e/host-states.sh and apps/mobile/.eas/workflows/e2e-ios.yml still reference the deleted sign-in.yml. They're not skills, so this PR doesn't fix them.
  • The superset:environment skill runs superset integrations github … and superset connections github …, which were internal-only. #9259 makes them public.

Summary by CodeRabbit

  • Plugin Updates
    • Updated nine integrations, with improvements to GitHub tool access, Notion search, Sentry error investigation, and meeting-history searches in Circleback and Granola.
    • Refined Linear duplicate handling, Peec action tracking, Stripe dispute guidance, and Superhuman account selection.
  • Documentation
    • Updated setup and workspace guidance, including settings locations and local troubleshooting steps.
    • Improved instructions for creating tasks and plans, and for running the full test suite.