Labsco
getsentry logo

xcodebuildmcp-tool-contract-review

✓ Official★ 6,033

by getsentry · part of getsentry/xcodebuildmcp

Use when reviewing XcodeBuildMCP tool contract changes across implementation, manifests, workflow membership, output schema metadata, and next-step templates.

🧰 Not standalone. This skill ships with getsentry/xcodebuildmcp and only works together with that tool — install the tool first, then add this skill.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

XcodeBuildMCP Tool Contract Review

Review guardrails for tool contract changes across implementation, manifests, and workflow exposure.

Review scope

  • Review-only by default.
  • Do not edit product code unless the user explicitly requests implementation changes.

Files to inspect

  • src/mcp/tools/**
  • manifests/tools/*.yaml
  • manifests/workflows/*.yaml
  • src/core/manifest/schema.ts
  • src/runtime/tool-catalog.ts
  • src/runtime/types.ts
  • xcodebuildmcp.com/app/docs/_content/tool-authoring.mdx
  • xcodebuildmcp.com/app/docs/_content/architecture-manifest-visibility.mdx

Guardrails

  • Manifest id matches filename.
  • Manifest module points to implementation path without extension.
  • Tool module exports named schema and handler.
  • names.mcp remains globally unique.
  • names.cli stays workflow-local and consistent with CLI docs/fixtures.
  • Tool appears in at least one workflow unless intentionally hidden by availability.
  • outputSchema is present for tools that set ctx.structuredOutput.
  • nextSteps.toolId references existing manifest tool IDs.
  • Avoid parallel legacy paths or duplicate implementation paths.

Validation

  • npm run typecheck
  • npm test -- src/core/manifest/__tests__/schema.test.ts
  • npm test -- src/runtime/__tests__/tool-invoker.test.ts
  • npx skill-check .agents/skills/xcodebuildmcp-tool-contract-review