Skip to content

docs: add an agent skills marketplace for the Angular skills - #71913

Open
GamerDubz wants to merge 3 commits into
angular:mainfrom
GamerDubz:feat/claude-plugin-marketplace
Open

GamerDubz wants to merge 3 commits into
angular:mainfrom
GamerDubz:feat/claude-plugin-marketplace

Conversation

@GamerDubz

@GamerDubz GamerDubz commented Nov 10, 2026 •

Copy link
Copy Markdown

PR Checklist

PR Type

  • Bugfix
  • Feature
  • Documentation content changes
  • Other... Please describe: distribution manifests for the existing agent skills in skills/dev-skills

What is the current behavior?

The agent skills in skills/dev-skills are published to angular/skills and installed with npx skills add. There is no marketplace file, so agents cannot install them as a plugin.

Issue Number: #71912

What is the new behavior?

Adds a generic agent marketplace (skills/dev-skills/.agents/plugins/marketplace.json) so any compatible coding agent can find the existing Angular skills, plus Claude Code and Codex listings (skills/dev-skills/.claude-plugin/marketplace.json and skills/dev-skills/.codex-plugin/plugin.json) that share the same metadata (display name, logo, website, description). The plugin root is skills/dev-skills/. The skills themselves are not copied or changed, so there is still one source of truth.

Install examples:

  • Claude Code: claude plugin marketplace add angular/skills then claude plugin install angular@angular
  • Codex: add angular/skills as a marketplace and enable angular@angular

Other agents that read the .agents marketplace format can add this repository as a marketplace and install the same plugin.

The files sit inside skills/dev-skills because the publish script exports that folder to the root of angular/skills, so the install examples above work against angular/skills after the next publish.

Does this PR introduce a breaking change?

  • Yes
  • No

Other information

Verified

  • claude plugin validate . passes, and a local checkout of this branch installed as a marketplace lists both skills from the real files in skills/dev-skills/.
  • The .agents marketplace and Codex manifest follow the Codex plugin docs and loader (marketplace.rs, manifest.rs): a local source to the plugin root, and skill paths that start with ./, stay inside the plugin root and each hold a SKILL.md.

Not verified

  • Installing from GitHub (marketplace add angular/skills) can only be tested once the files are published to angular/skills; I tested the same manifests from a local copy of skills/dev-skills.
  • I could not run this repo's own prettier/lint config, so the JSON is formatted with Prettier/Node defaults.

Related: #71912 (kept open for discussion; the contributing guide lets small features go straight to a PR).

Thanks to @geromegrignon for pointing out that angular/skills is exported from skills/dev-skills by scripts/ci/publish-snapshot-build-artifacts.sh, which is why the files live there rather than at the repository root. That script uses git archive, which includes dot-folders, but I have not run the publish job.

@angular-robot angular-robot Bot added the area: docs Related to the documentation label Nov 10, 2026
@google-cla

This comment was marked as outdated.

@erkamyaman

Copy link
Copy Markdown
Contributor

You need to remove Claude Code from the commit as it is now the co-author. Until you do CLA will fail regardless you signed it or not.

@GamerDubz

Copy link
Copy Markdown
Author

Closing this PR so the proposal goes through the issue first, as the contributing guide asks. I'm reopening #71912 for that. The branch stays on my fork and I'll only reopen a PR if the maintainers want one: https://github.com/GamerDubz/angular/tree/feat/claude-plugin-marketplace

@GamerDubz GamerDubz closed this Nov 10, 2026
@GamerDubz

Copy link
Copy Markdown
Author

Reopening: the contributing guide lets small features go straight to a pull request and says an issue is ideal but not required. #71912 stays open and is linked above.

@GamerDubz GamerDubz reopened this Nov 10, 2026
@GamerDubz
GamerDubz force-pushed the feat/claude-plugin-marketplace branch from c68cd62 to c3e6134 Compare November 10, 2026 07:43
@GamerDubz GamerDubz changed the title docs: add a Claude Code plugin marketplace for the Angular agent skills docs: add Claude Code and Codex plugin marketplaces for the Angular agent skills Nov 10, 2026
@GamerDubz
GamerDubz force-pushed the feat/claude-plugin-marketplace branch from c3e6134 to f5a4d65 Compare November 10, 2026 08:12
@geromegrignon

Copy link
Copy Markdown
Contributor

@GamerDubz the skillsrepo is updated through the Github Actions, using this script: https://github.com/angular/angular/blob/main/scripts/ci/publish-snapshot-build-artifacts.sh#L126

So the files should be in the skills/dev-skills folder to expose them at the root of the angular/skills repo.

@GamerDubz
GamerDubz force-pushed the feat/claude-plugin-marketplace branch from f5a4d65 to 8d557d1 Compare November 10, 2026 11:23
@GamerDubz

Copy link
Copy Markdown
Author

Thanks @geromegrignon, that makes sense. I moved the manifests into skills/dev-skills (they were at the repository root) so the publish script's git archive exports them to the root of angular/skills. I installed them from a local copy of that folder in Claude Code; the Codex files are untested.

@GamerDubz
GamerDubz force-pushed the feat/claude-plugin-marketplace branch from 8d557d1 to 0538642 Compare November 10, 2026 11:38
@GamerDubz

Copy link
Copy Markdown
Author

Thanks @erkamyaman, I removed the Claude co-author trailer from the amended commit, and cla/google is now green.

@pullapprove
pullapprove Bot requested a review from MarkTechson November 10, 2026 21:17
GamerDubz and others added 2 commits November 10, 2026 23:20
Add Codex interface details, Claude marketplace listing fields, and the
official Angular logo so marketplace listings show website, branding,
and accurate skill descriptions.

Co-authored-by: GamerDubz <GamerDubz@users.noreply.github.com>
@GamerDubz
GamerDubz force-pushed the feat/claude-plugin-marketplace branch from 8f552ba to caf4a3b Compare November 10, 2026 21:20
@GamerDubz GamerDubz changed the title docs: add Claude Code and Codex plugin marketplaces for the Angular agent skills docs: add an agent skills marketplace for the Angular skills Nov 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: docs Related to the documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants