Purpose
Centralizes references consumed by multiple do-* execution skills. Avoids duplication of the MCP capability registry and the discovery procedure across skills.
Contents
references/do-mcp-capabilities.md: Registry mapping each configured MCP server to its capabilities, tool prefix, runtime requirements, and unavailability handling.references/do-mcp-discovery-instructions.md: Standard procedure for discovering MCP servers in the active AI tool's configuration file and applying the capability guard.references/do-service-readiness.md: Standard procedure for checking, reusing, and starting services (frontend dev server, backend API, broker, database) before invoking MCP tools or E2E tests. Enforces "check first, reuse if running, start only when needed, never kill running services".
Consumers
The following skills read these references at runtime:
do-execute-taskdo-execute-qado-execute-qa-bugfixdo-execute-review
Usage
This skill is not user-invocable. Other do-* skills cite the absolute path (e.g., do-shared/references/do-mcp-capabilities.md) when their procedure requires the registry or the discovery flow.
Error Handling
- If a consumer skill cannot locate
do-shared/references/do-mcp-capabilities.md, halt and report the missing dependency — do not fall back to hardcoded MCP assumptions. - If a new MCP is configured by the user but absent from the registry, add an entry to
do-shared/references/do-mcp-capabilities.mdfollowing the existing schema; no skill code needs to change.
References
- MCP Registry:
do-shared/references/do-mcp-capabilities.md - MCP Discovery:
do-shared/references/do-mcp-discovery-instructions.md - Service Readiness:
do-shared/references/do-service-readiness.md