How SkillRelay works
For everyone (the 30-second version)
Your company has shared Claude skills — reusable instructions Claude follows for common workflows (filing bugs, writing reports, onboarding customers). You get them automatically. To change one, you don't file a ticket or edit a file: you tell Claude what's wrong, in a normal chat.
- “What team skills do we have?” — Claude lists them.
- “The file-a-bug skill points at the wrong Linear team — it should be Platform.” — Claude reads the skill, drafts the fix, applies it, and tells you how many people it reaches.
- “Save how we write release notes as a team skill.” — Claude creates it for everyone.
- “Yesterday's change to the demo skill made it worse — put it back.” — Claude shows the history and reverts it.
The only setup you personally ever do: add the SkillRelay connector to Claude once (Settings → Connectors → Add custom connector) using the URL on your team's Settings page, and sign in with your work email so your edits carry your name.
For the admin
The setup checklist walks you through it: create the workspace, let SkillRelay create a private GitHub repo in your org, install Anthropic's Claude GitHub App on that one repo, and point claude.ai's admin settings at it (add marketplace → Sync automatically → set the plugin to Required). Five minutes, once. Every future skill and edit ships with zero admin involvement, because the plugin already exists — only its contents change.
Approvals: off by default, there when you want them
By default, safety comes from undo, not gatekeeping: every change is an immutable version with a named author, anyone can revert anything in one sentence, and the full history is visible to everyone. A fix that waits three days on a reviewer is a fix nobody makes — so start here.
For teams that want a gate, an admin can turn on approvals in Settings. Then:
- Default skills (the set everyone gets automatically) need a workspace admin to approve changes — the curated set stays curated.
- Optional skills (each one an individually-enabled plugin, so it lands only on Claudes that opted in) are approved by their owner — nobody's work gets trampled — or set per-skill to admin-approval or open.
- Admins always publish directly, and you never wait on yourself for your own skills. New skills default to optional, so creating stays instant.
- When a change needs sign-off, Claude gives the author the review link and offers to ping the reviewer on Slack — approval is one click in the app.
Security model, honestly stated
- New members start read-only. Joining (via invite or a sign-in link) makes you a Reader — full use of every skill, no edit rights. Admins promote people to Editor when they should be able to change things, can regenerate the invite link, and can remove members (which revokes their access tokens instantly).
- Skills are instructions Claude follows. A malicious member could write a skill that misleads teammates' Claude sessions. Membership should mean employment; remove people when they leave.
- Sign-in links expire in 15 minutes and work once. All tokens are stored hashed. Edits are attributed via OAuth — there are no shared credentials.
- The GitHub repo is private, in your org, and only ever written by SkillRelay and read by Anthropic's sync.
Beyond Claude
The library isn't locked to one vendor. Claude gets the best experience — skills auto-distribute through plugins — but the connector is a standard MCP server, so any MCP-capable tool (ChatGPT's developer-mode connectors, Cursor, and friends) can connect to the same URL and read or edit the same skills with the same per-person sign-in. For tools that only eat text, Settings has a one-click Markdown export of the whole library, ready to paste into project instructions or an AGENTS.md.
When something goes wrong
- A skill got worse: tell Claude to revert it (or check its history on the Skills page).
- A publish failed: the error shows on Settings and in the next Claude edit response. Fix the cause (usually GitHub permissions) and press “Publish now”.
- GitHub is down or not set up: download the plugin ZIP from Settings — it's the identical content.