Skip to content

feat: add Gemini CLI extension support (closes #3)#12

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

feat: add Gemini CLI extension support (closes #3)#12
addyosmani merged 2 commits into
addyosmani:mainfrom
federicobartoli:feat/gemini-extension-support

Conversation

@federicobartoli

Copy link
Copy Markdown
Contributor

Closes #3.

Summary

Make this repo installable as a Gemini CLI extension with a single command, while keeping skills/ as the single source of truth shared with Claude Code. No files are copied, no installer script, no wrapper skills.

gemini extensions install https://github.com/addyosmani/web-quality-skills

What this adds

  • gemini-extension.json — extension manifest at the repo root. Gemini CLI auto-discovers the existing skills/ directory; no explicit path field is needed.
  • .gemini/skills — git-tracked symlink to ../skills (9 bytes, mode 120000). This is the symlink suggested in Add skills in Gemini #3: it enables workspace mode so Gemini CLI auto-loads the same skills when launched from a clone of this repo, without going through gemini extensions install.
  • docs/gemini-setup.md — install, workspace mode, and Windows fallback.
  • README.md — Gemini CLI install section under Quick start.

Net change: 4 files, ~69 lines, 0 duplicated skill content.

Why no skills field in gemini-extension.json

Per the Gemini CLI extension reference, the skills/ subdirectory is a fixed convention — Gemini CLI auto-discovers skills/<name>/SKILL.md from the extension root. Since this repo already has skills/ at the root, the manifest stays minimal.

Why the .gemini/skills symlink

Issue #3 specifically asked: "Wonder if you can synlink the skills to different folders e.g. .gemini/skills". Gemini CLI also looks at .gemini/skills/ for workspace skills, which load automatically when Gemini CLI runs inside the repo. The git-tracked symlink wires that up out of the box, no copy required.

Compatibility

Gemini CLI and Claude Code share the same SKILL.md format (YAML frontmatter with name + description). The existing 6 skills work as-is on both platforms.

Verified

Tested locally with Gemini CLI:

  • gemini extensions install /path/to/local/clone succeeds.
  • All 6 skills auto-discovered:
    • web-quality-audit
    • performance
    • core-web-vitals
    • accessibility
    • seo
    • best-practices
  • Workspace mode also works: launching gemini from inside the repo picks up the symlinked skills.

Relation to other PRs on this repo

  • #10 — Codex plugin support (same no-duplication approach).
  • #11 — Claude Code plugin support.

Same intent across the three PRs: one skills/ directory, three install paths, zero duplication.

Test plan

  • gemini extensions install /path/to/local/clone succeeds
  • All 6 skills auto-discovered after install
  • Workspace mode loads .gemini/skills when running gemini from the repo root
  • Skills auto-activate on relevant prompts after install (pending maintainer verification)

federicobartoli and others added 2 commits May 8, 2026 13:37
Closes addyosmani#3.

Make this repo installable as a Gemini CLI extension with a single
command, while keeping skills/ as the single source of truth shared with
Claude Code. No files are copied, no installer script, no wrapper skills.

  gemini extensions install https://github.com/addyosmani/web-quality-skills

Adds:
- gemini-extension.json — extension manifest at the repo root.
  Gemini CLI auto-discovers the existing skills/ directory; no explicit
  path field is needed.
- .gemini/skills — git-tracked symlink to ../skills (mode 120000).
  Enables workspace mode (Gemini CLI auto-loads skills from
  .gemini/skills when launched inside the repo), as suggested in addyosmani#3.
- docs/gemini-setup.md — install + workspace mode + Windows fallback.
- README.md — Gemini CLI install section.

Gemini CLI and Claude Code share the same SKILL.md format (YAML
frontmatter with name + description), so one file serves both platforms.
Resolve README.md conflict by keeping both the Gemini CLI install
section (this PR) and the Codex plugin install section (added in addyosmani#10
on main). The two are complementary, not competing — ordered Codex
then Gemini CLI alphabetically for stable ordering as more platforms
are added.
@addyosmani addyosmani merged commit 7b59d48 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