Skip to content

[FEATURE] Add Claude Code as a supported agent surface (.claude-plugin manifests) #12

Description

@vmlepaulino

Feature Description

Make the Spec2Cloud lean and speckit plugins installable in Claude Code (Anthropic's agent CLI), alongside the existing GitHub Copilot support — without changing or duplicating the skill content.


Problem Statement

Today the plugins are surfaced only through the GitHub Copilot plugin marketplace (copilot plugin marketplace add Azure-Samples/Spec2Cloud) and APM. The skill content itself (the SKILL.md files with name/description frontmatter under each plugin's skills/ directory) is already in the portable format that Claude Code reads natively. The only thing preventing Claude Code users from installing the toolkit is the manifest location: Claude Code discovers plugins via .claude-plugin/marketplace.json (repo root) and .claude-plugin/plugin.json (per plugin), whereas this repo places them under .github/plugin/ (the Copilot convention).


Proposed Solution

Additive only — leave the Copilot path (.github/plugin/...) completely untouched:

  1. Add /.claude-plugin/marketplace.json at the repo root, porting the existing .github/plugin/marketplace.json so users can run /plugin marketplace add Azure-Samples/Spec2Cloud in Claude Code.
  2. Add .claude-plugin/plugin.json to each plugin (plugins/lean-spec2cloud/, plugins/speckit-spec2cloud/), mirroring the existing .github/plugin/plugin.json.
  3. Add a "Use with Claude Code" section to the README documenting the install commands.

The existing skills/ directories are discovered automatically by Claude Code, so no skill files need to change.

Possible follow-ups (out of scope for the first PR)

  • A package-*-claude-plugin skill mirroring the existing package-speckit-spec2cloud-plugin skill, so the Claude manifests stay generated/in-sync with source.
  • Neutralizing the few Copilot-only content references (/fleet usage in the README, also emitting CLAUDE.md next to .github/copilot-instructions.md).

Alternative Solutions

  • Local-only binding (drop skills into ~/.claude/skills/): works for individuals but isn't shareable/installable, so it doesn't serve the catalog's distribution goal.
  • Separate repo for Claude manifests: fragments the source of truth; keeping one repo with per-target manifests matches the existing pattern (Copilot + VS Code + APM already coexist here).

Use Cases

  • A developer who uses Claude Code wants the same Azure spec → plan → implement → verify → deploy loop without switching to Copilot.
  • A team standardizing on Claude Code can /plugin marketplace add Azure-Samples/Spec2Cloud and get the lean/speckit skills, identical to the Copilot experience.

Benefits

  • Broader reach: one toolkit, multiple agent harnesses (Copilot, VS Code, APM, and now Claude Code).
  • Zero duplication: same SKILL.md source serves all targets.
  • Low risk: purely additive; no change to existing Copilot/VS Code behavior.

Additional Context

Happy to implement this. Opening per CONTRIBUTING.md ("submit an issue with a proposal for your work first") — a PR with items 1–3 will follow shortly, scoped small and additive.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions