Guide
How to share Claude skills on GitHub, and who it reaches
GitHub is a good way to share Claude skills with people who use Claude Code: commit the skills to a project's .claude/skills folder so everyone who clones it gets them, or publish them as a Claude Code plugin marketplace that teammates add once and receive updates from. For colleagues who use Claude in the browser or desktop app, GitHub is only a download page: each person uploads every skill as a ZIP and re-uploads each new version. Mixed teams usually need a second route for those people.
Short answer
- Skills for one codebase: commit them to
.claude/skillsin that repository. - Skills for a whole engineering team: a plugin marketplace repository.
- Colleagues in claude.ai or the desktop app: GitHub doesn't install anything for them.
- Non-technical teammates: Claude Team deployment, or a shared skill library.
Three ways compared
Project .claude/skills | Plugin marketplace | Plain repo to download from | |
|---|---|---|---|
| Who it reaches | Claude Code users working in that repository | Claude Code users who add the marketplace | Anyone who downloads and uploads |
| Setup per person | Clone the repo | claude plugin marketplace add owner/repo, then install | Download, zip, upload in Customize > Skills |
| Updates | On git pull | Through plugin updates | Manual, every time |
| Private | Yes, a private repo | Yes, a private repo | Yes, a private repo |
From the Claude Code docs and Claude Help Center, read 5 November 2026.
A worked example: one repo, two kinds of teammate
Illustration: a made-up business. A 12-person software agency keeps its skills in a private repository, acme-studio/skills: a code-review checklist, a release-notes writer and a client status report. Engineers and project managers both need them.
- Engineers add the repository as a plugin marketplace once. The code-review skill runs in Claude Code as
/studio:code-review, and Claude picks the release-notes skill when they ask for release notes. When the lead edits a skill, it reaches them through plugin updates. - Project managers use Claude in the browser. For them the repository is a folder of files. The first month, two of the four were using an old status-report skill because they'd never re-uploaded it.
The fix was a second route for the project managers, not more reminders. Their status-report skill now comes from one place their Claude connects to, and the engineers keep GitHub.
Set up a skills marketplace on GitHub
- Make a repository with a
plugins/folder. Each plugin is a folder whose skills sit inskills/<skill-name>/SKILL.md. - Add
.claude-plugin/marketplace.jsonwith aname, anownerand apluginslist; each entry has anameand asourcesuch as./plugins/studio. - Validate it:
claude plugin validate . - Push it to GitHub; a private repository works for people with access.
- Teammates run
claude plugin marketplace add acme-studio/skills, thenclaude plugin install studio@<marketplace-name>.
Teammates who don't use GitHub
Most teams have them: managers, sales, support, the freelancer. Three ways to reach them without downloads:
- Claude Team or Enterprise: an owner deploys the skills to the organization. Only reaches people in your Claude organization.
- Their own claude.ai account: skills they enable there also sync into Claude Code, so one upload serves both apps on their machine.
- A shared skill library over MCP: one copy, connected from Claude on any plan, ChatGPT Pro, Business or Enterprise, and coding agents. AI Skill Pod is one, with Free for up to 3 members and 10 skills.
Sending teammates the link? How to install Claude skills from GitHub is their side: claude.ai, Claude Code and Codex, step by step. Writing the skills themselves in Claude Code? How to create Claude skills in Claude Code covers the file. For all seven sharing methods side by side, see the best ways to share AI skills with a team.
The AI skill below turns a prompt or doc into a correctly formed skill, with a name and a "use when" description, ready to commit to the repository.
Skills for this
- AI practiceTurn a prompt into a skillTurns a prompt that works into a skill the whole team can reuse, with a valid name, a when-to-use description, steps, an output template, an example, and checks.
- Operations and adminSOP from an explanation or recordingTurns an explanation or screen-recording transcript into an SOP with a trigger, roles, exact-label steps, decision points, checks, and an owner.
- ProductRelease notes from merged changesWrites customer-facing release notes from merged PRs or tickets, grouped New, Improved, Fixed, benefit-first, plus an internal changelog.
Questions
How do I share Claude skills with my team on GitHub?
For Claude Code users, commit the skills to the project's .claude/skills folder, or publish them as a plugin marketplace that teammates add once with claude plugin marketplace add owner/repo. For people who use Claude in the browser or desktop app, GitHub is only a download place: they upload each skill as a ZIP.
Do teammates get updates automatically?
Project skills update when people pull the repository. Marketplace plugins update through Claude Code's plugin updates. Skills uploaded as ZIPs to claude.ai don't update; each person uploads the new version.
How do I distribute skills to coworkers who don't use GitHub?
Upload them in their Claude account, deploy them to everyone on Claude Team or Enterprise, or serve them from a shared skill library their AI connects to, so nobody downloads anything.
AI skill
Have your AI turn a prompt that works into a skill your team can reuse
Put this skill in AI Skill Pod and everyone on your team gets it in their Claude, Cursor or ChatGPT (Pro, Business, Enterprise): one invite link, free to start. Turn a prompt into a skill has your AI turn a prompt or doc into a correctly formed skill folder, ready to commit to the repository.
14 days free · No card needed
Sources
- Claude Code Docs: Skills — project skills in .claude/skills: commit them to share; plugin skills; claude.ai skills sync to ~/.claude/skills/synced (read 2026-11-05)
- Claude Code Docs: Create a marketplace — .claude-plugin/marketplace.json; claude plugin marketplace add owner/repo; private repos allowed (read 2026-11-05)
- Claude Help Center: How to create custom skills — claude.ai takes a ZIP upload in Customize > Skills (read 2026-11-05)
- Agent Skills specification (read 2026-11-05)
- Anthropic: example skills on GitHub — a public skills repository (read 2026-11-05)