Skip to content

feat: add Claude Code plugin support#11

Merged
addyosmani merged 2 commits into
addyosmani:mainfrom
federicobartoli:feat/claude-plugin-support
May 9, 2026
Merged

feat: add Claude Code plugin support#11
addyosmani merged 2 commits into
addyosmani:mainfrom
federicobartoli:feat/claude-plugin-support

Conversation

@federicobartoli

Copy link
Copy Markdown
Contributor

Summary

Make this repo installable as a Claude Code plugin from inside the CLI, alongside the existing manual cp -r skills/* ~/.claude/skills/ path. No skill content is duplicated — the same skills/ directory powers both install methods.

/plugin marketplace add addyosmani/web-quality-skills
/plugin install web-quality-skills@addy-web-quality-skills

What this adds

  • .claude-plugin/plugin.json — plugin manifest (name, version, description, author, homepage, repository, license).
  • .claude-plugin/marketplace.json — marketplace entry (addy-web-quality-skills) pointing at the GitHub source.
  • README.md — Claude Code plugin install section under Quick start.

Net change: 3 files, ~42 lines, 0 duplicated skill content.

Why no skills field in plugin.json

Claude Code's plugin loader auto-discovers skills/<name>/SKILL.md from the plugin root when no explicit "skills" field is set. Since this repo already has skills/ at the root, the manifest stays minimal and the existing directory is reused as-is.

Verified

Tested locally with /plugin marketplace add /path/to/local/clone:

  • Marketplace addy-web-quality-skills registered.
  • Plugin web-quality-skills installed and enabled.
  • All 6 skills loaded under the plugin namespace:
    • web-quality-skills:web-quality-audit
    • web-quality-skills:performance
    • web-quality-skills:core-web-vitals
    • web-quality-skills:accessibility
    • web-quality-skills:seo
    • web-quality-skills:best-practices

Relation to other PRs on this repo

  • Companion PR — #10 adds Codex plugin support with the same no-duplication approach.
  • A Gemini CLI extension PR will follow to close #3.

Test plan

  • /plugin marketplace add /path/to/local/clone succeeds
  • /plugin install web-quality-skills@addy-web-quality-skills succeeds
  • All 6 skills visible in /plugin UI under the plugin namespace
  • Skills auto-activate on relevant prompts after install (pending maintainer verification)

Make this repo installable as a Claude Code plugin from inside the CLI:

  /plugin marketplace add addyosmani/web-quality-skills
  /plugin install web-quality-skills@addy-web-quality-skills

Adds:
- .claude-plugin/plugin.json — manifest (name, version, description,
  author, homepage, repository, license). The skills/ directory at the
  repo root is auto-discovered; no explicit "skills" field needed.
- .claude-plugin/marketplace.json — marketplace entry pointing at the
  github source.
- README.md — Claude Code plugin install section.

After install all 6 skills are namespaced under the plugin (e.g.
web-quality-skills:performance) and tracked via /plugin update.

@addyosmani addyosmani left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

LGTM. Thank you!

Resolve README.md conflict by keeping both the Claude Code plugin
install section (this PR) and the Codex plugin install section (added
in addyosmani#10 on main). The two are complementary, not competing — Claude
Code listed first since this repo's primary audience is Claude Code,
matching the existing manual `cp -r skills/* ~/.claude/skills/`
fallback above.
@addyosmani addyosmani merged commit 9751cda into addyosmani:main May 9, 2026
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.

Add skills in Gemini

2 participants