docs: fix broken skill reference in mcp-config.md (#897) #933

Gap

Issue #897: mcp-config.md and squad.agent.md reference non-existent skill. Broken references erode user trust.

Specific Broken Reference

Files containing the broken reference:

• .squad/mcp-config.md (line ~line 10, in the blockquote callout)
• .squad-templates/squad.agent.md (line ~line 10, in the blockquote callout)
• templates/mcp-config.md (line ~line 10, in the blockquote callout)
• .squad/templates/mcp-config.md (line ~line 10, in the blockquote callout)
• .squad-templates/mcp-config.md (line ~line 10, in the blockquote callout)

Exact broken reference:

Read `.squad/skills/mcp-tool-discovery/SKILL.md` for discovery patterns, domain-specific usage, and graceful degradation.

Where it appears: Inside a blockquote that starts with > **Full patterns:**

The skill does not exist in the bradygaster/squad repository. The path .squad/skills/mcp-tool-discovery/SKILL.md is referenced but the directory/file is not present.

What's Needed

1. Remove or update broken reference — either:
   • Remove the broken reference line entirely if this skill is not planned, OR
   • Create the missing .squad/skills/mcp-tool-discovery/SKILL.md documentation if the skill is intentional
2. Verify all skill references in templates and agent configs
3. Add acceptance criteria — verify by searching the repo for any remaining references to non-existent skills

Acceptance Criteria

• All references to .squad/skills/mcp-tool-discovery/SKILL.md are either removed or the file is created
• Search confirms no other broken skill references remain in mcp-config.md or squad.agent.md files
• Issue bug: mcp-config.md and squad.agent.md refers to non-existent tool discovery skill #897 linked as resolved by this work

Related

• Issue bug: mcp-config.md and squad.agent.md refers to non-existent tool discovery skill #897 — Original bug report

Source: docs-opportunity-scanner (2026-04-08)