docs: make the skill index agent-neutral (Copilot + Claude) and add install helper#24
Merged
Merged
Conversation
…nstall helper The skills are agent-neutral (agentskills.io spec), but the README only documented the default Copilot install path. This reframes the index as multi-agent and makes installing for both Copilot and Claude Code first-class: - README: explain agent-neutrality up front; add an "Installing" section with explicit github-copilot and claude-code user-scope examples (-> ~/.copilot/skills and ~/.claude/skills). - Add scripts/install.sh: installs every indexed skill for the agents you name (default: github-copilot + claude-code) at user scope. It parses the install commands out of README.md, so it never drifts from the index. - Point the "Automated installation and updates" section at the renamed agent-neutral actions/workflow (setup-agent-skills / update-agent-skills / update-agent-skills.yaml). Index hygiene (both entries were broken for every agent): - Remove the `gh-cli` row — the skill was deleted from github/awesome-copilot in its move to the plugins/ layout, so the install command no longer resolves. - Add `--allow-hidden-dirs` to the `bubbletea` command — its SKILL.md lives in a hidden `.claude/skills/` dir, which gh skill skips by default. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the repository documentation to better reflect that the indexed SKILL.md files are agent-neutral and can be installed for multiple supported agents, and adds a helper script to bulk-install the indexed skills at user scope.
Changes:
- Add an Installing section with explicit
--agent/--scope userexamples for GitHub Copilot and Claude Code. - Update the index hygiene: remove the broken
gh-clientry and add--allow-hidden-dirsto thebubbleteainstall command. - Add
scripts/install.shto install all indexed skills for one or more agents (defaulting to Copilot + Claude Code).
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| README.md | Documents agent-neutral usage, adds Installing section and updates index/install commands and automation links. |
| scripts/install.sh | New helper script that parses gh skill install commands from the README and installs them for selected agents at user scope. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
…install errors Restrict the curated-index scan to the "## Skills" section (up to the next "## " heading) so example commands under "## Installing" can never be picked up as installable entries, and print the captured install output on failure instead of discarding it to /dev/null so errors (auth, network, missing skill) are actionable. Addresses the install.sh review threads on #24.
![botantler[bot]](https://avatars.githubusercontent.com/in/1025824?s=60&v=4){kind=small}
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.
Why
These skills are agent-neutral (every
SKILL.mdfollows the agentskills.io spec), so the same skill installs into GitHub Copilot, Claude Code, Cursor, … viagh skill --agent. The README only documented the default Copilot path, so the multi-agent story wasn't discoverable. This makes installing for both Copilot and Claude Code first-class.What changed
--agent github-copilot/--agent claude-codeuser-scope examples (→~/.copilot/skillsand~/.claude/skills).scripts/install.sh(new): installs every indexed skill for the agents you name (defaultgithub-copilot claude-code) at user scope. It parses the install commands straight out ofREADME.md, so it never drifts from the index. shellcheck-clean.setup-agent-skills,update-agent-skills,update-agent-skills.yaml(see actions#178 and reusable-workflows#246; those doc links resolve once those PRs merge).Index hygiene (discovered while installing every skill)
Both of these were broken for every agent, not just one:
gh-clirow —github/awesome-copilotdeleted that skill in its move to theplugins/<plugin>/skills/layout, sogh skill install github/awesome-copilot gh-clino longer resolves (skill "gh-cli" not found).bubbleteanow uses--allow-hidden-dirs— itsSKILL.mdlives in a hidden.claude/skills/directory, whichgh skillskips by default.Validation
scripts/install.shparses exactly the 19 indexed skills and was run againstclaude-codeandgithub-copilotat user scope — all install successfully (incl.bubbleteavia--allow-hidden-dirs).