Skip to content

fix(claude): don't project Copilot's template Init Mode skills - #2504

Merged
bradygaster merged 2 commits into
devfrom
squad/claude-drop-template-init-skills
Nov 14, 2026
Merged

bradygaster merged 2 commits into
devfrom
squad/claude-drop-template-init-skills

Conversation

@bradygaster

Copy link
Copy Markdown
Collaborator

Claude Code was getting three Init Mode skills:

  • squad-coordinator-init-mode: Claude's own. It uses defaults instead of stopping to ask, casts with squad cast, and stops if a cast is denied. The coordinator is told to load this one, and it's the only one live runs loaded (4 of 4).
  • init-mode and coordinator-init-mode: Copilot's templates. Both say "DO NOT create any files until the user confirms", rely on an ask_user tool Claude Code doesn't have, and describe writing the team by hand.

Claude Code picks skills by their descriptions, so a request like "set up my team" could load a template skill that contradicts the coordinator. This PR skips both template skills in project mode and in the plugin (CLAUDE_SKIPPED_TEMPLATE_SKILLS). Squad-generated copies already in .claude/skills/ are removed on the next squad upgrade. Copilot's output doesn't change.

Tests: test/claude-skills.test.ts covers project mode and the committed plugin tree. The plugin is regenerated, still pinned to 2.0.0-preview.4.

🤖 Generated with Claude Code

init-mode and coordinator-init-mode wait for confirmation through ask_user
(which Claude Code lacks) and hand-write the team, contradicting Claude's
coordinator. Claude uses squad-coordinator-init-mode. Removed from project
mode and the plugin; previously generated copies are removed on upgrade.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI dynamic review requested due to automatic review settings November 14, 2026 17:41
@github-actions

github-actions Bot commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

🟡 Impact Analysis — PR #2504

Risk tier: 🟡 MEDIUM

📊 Summary

Metric Count
Files changed 6
Files added 0
Files modified 4
Files deleted 2
Modules touched 3

🎯 Risk Factors

  • 6 files changed (6-20 → MEDIUM)
  • 3 modules touched (2-4 → MEDIUM)
  • 2 file(s) deleted

📦 Modules Affected

root (3 files)
  • CHANGELOG.md
  • plugins/squad/skills/coordinator-init-mode/SKILL.md
  • plugins/squad/skills/init-mode/SKILL.md
squad-sdk (2 files)
  • packages/squad-sdk/src/client/adapters/claude-plugin.ts
  • packages/squad-sdk/src/client/adapters/claude-skills.ts
tests (1 file)
  • test/claude-skills.test.ts

This report is generated automatically for every PR. See #733 for details.

@github-actions

github-actions Bot commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

🛫 PR Readiness Check

ℹ️ This comment updates on each push. Last checked: commit d28e5c3

PR Scope: 📦🔧 Mixed (product + infrastructure)

⚠️ 3 item(s) to address before review

Status Check Details
❌ Single commit 2 commits — consider squashing before review
✅ Not in draft Ready for review
✅ Branch up to date Up to date with dev
❌ Copilot review No Copilot review yet — it may still be processing
✅ Changeset present CHANGELOG.md edit found
✅ Scope clean No .squad/ or docs/proposals/ files
✅ No merge conflicts No merge conflicts
✅ Copilot threads resolved No Copilot review threads
❌ CI passing 1 check(s) still running

Files Changed (6 files, +41 −207)

File +/−
CHANGELOG.md +1 −0
packages/squad-sdk/src/client/adapters/claude-plugin.ts +2 −1
packages/squad-sdk/src/client/adapters/claude-skills.ts +9 −1
plugins/squad/skills/coordinator-init-mode/SKILL.md +0 −100
plugins/squad/skills/init-mode/SKILL.md +0 −105
test/claude-skills.test.ts +29 −0

Total: +41 −207


This check runs automatically on every push. Fix any ❌ items and push again.
See CONTRIBUTING.md and PR Requirements for details.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues were identified for the changes excluding conflicting template initialization skills from Claude output.

No open issues 🎉

What changed in this PR

This PR keeps Claude Code’s initialization guidance consistent by excluding Copilot’s two template Init Mode skills from project projection and the plugin, while retaining squad-coordinator-init-mode. Copilot output remains unchanged.

Changes:

  • Apply a shared template-skill exclusion set to both Claude output paths.
  • Remove the conflicting plugin skills and add regression coverage for their exclusion.
  • Document the behavior and record an SDK patch changeset.
File Description
test/​claude-skills.test.ts Adds project-projection and committed-plugin regression checks.
plugins/​squad/​skills/​init-mode/​SKILL.md Removes Copilot’s template initialization skill from the plugin.
plugins/​squad/​skills/​coordinator-init-mode/​SKILL.md Removes the conflicting coordinator initialization template.
packages/​squad-sdk/​src/​client/​adapters/​claude-skills.ts Defines and applies the shared exclusion set during project projection.
packages/​squad-sdk/​src/​client/​adapters/​claude-plugin.ts Applies the same exclusions during plugin generation.
CHANGELOG.md Documents Claude’s skill exclusions and upgrade cleanup behavior.
.changeset/​claude-no-template-init-skills.md Records the fix as an SDK patch release.

Review effort: Balanced (dynamic)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@bradygaster
bradygaster merged commit f5796cb into dev Nov 14, 2026
33 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants