feat: add Gemini CLI extension support (closes #3)#12
Merged
addyosmani merged 2 commits intoMay 9, 2026
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.What this adds
gemini-extension.json— extension manifest at the repo root. Gemini CLI auto-discovers the existingskills/directory; no explicit path field is needed..gemini/skills— git-tracked symlink to../skills(9 bytes, mode120000). 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 throughgemini 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
skillsfield ingemini-extension.jsonPer the Gemini CLI extension reference, the
skills/subdirectory is a fixed convention — Gemini CLI auto-discoversskills/<name>/SKILL.mdfrom the extension root. Since this repo already hasskills/at the root, the manifest stays minimal.Why the
.gemini/skillssymlinkIssue #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.mdformat (YAML frontmatter withname+description). The existing 6 skills work as-is on both platforms.Verified
Tested locally with Gemini CLI:
gemini extensions install /path/to/local/clonesucceeds.web-quality-auditperformancecore-web-vitalsaccessibilityseobest-practicesgeminifrom inside the repo picks up the symlinked skills.Relation to other PRs on this repo
Same intent across the three PRs: one
skills/directory, three install paths, zero duplication.Test plan
gemini extensions install /path/to/local/clonesucceeds.gemini/skillswhen runninggeminifrom the repo root