omgskills

omgskills

Share agent skills with your team.

OMGSkills helps teams organize and share skills for Claude Code and Codex, alongside a library of useful skills from trusted creators and sources.

Create sets of skills to share or explore the library. The web app works on its own; the Mac companion is optional for installing skills and reporting what is installed.

Share skills with your team

Bring the skills for a project or team together in a Set:

• Organize skills in one place so teammates can find what to use.
• Choose public, invite-only, or only-me access.
• Grant teammates access and share the Set's link. Access can be revoked later.

You can create and share Sets now. Invitations provide a copyable link; they do not send an invitation email.

Coming soon: installing a whole Set, installing the same Set version across a team, and automatic skill updates. Sharing a Set today does not automatically install or update skill files on teammates' machines.

Find useful skills

Browse the public library without an account. Discover skills through search, collections, trending lists, and creator and company profiles. Read a skill's description, SKILL.md and available README before deciding to use it.

Save useful skills to your library and Sets when signed in. The library complements your team's own skills, giving you a starting point for coding, design, marketing and other work.

"Trusted sources" describes where skills come from, not a guarantee that every skill is safe or security-audited. Review third-party instructions and code before using them.

Optional Mac companion

Start at omgskills.com/app/. Browse public skills without an account, organize Sets on the web, and choose a skill to open its Mac installation flow. Download the Mac companion 0.0.27 for Apple silicon and macOS 14 or later, or use the skill's setup panel. The original Mac app and its update feed remain available separately. Existing users are not automatically upgraded.

Connect the companion to your account to see installed skills by Mac and agent, including supported external installs. Sync keeps the installed-skills list up to date; it does not update skill files.

Use the library from your agent

The read-only MCP server lets agents search the public library, inspect skills and their content, find related skills, and request commit-pinned install plans where available.

Install the npm package:

npm install -g omgskills-mcp

Add it to your MCP client:

{
  "mcpServers": {
    "omgskills": {
      "command": "omgskills-mcp"
    }
  }
}

No repository checkout is needed. The MCP server reads public catalog data, not your private library or Sets. It returns install instructions but does not execute them or install skills itself.

See MCP setup, tools and data sources for hosted access, filters, paging and local configuration.

Development

This repository contains the web app, catalog pipeline, MCP server and Mac code.

Use Node.js 20 for web and MCP development. From the repository root:

npm ci
npm run dev:portal

See web app setup for authentication requirements, public catalog previews and the full local backend. MCP development instructions are in mcp/README.md.

Builds and releases

• The website and web app ship together. npm run build:netlify builds the combined dist/netlify-site artifact; do not deploy site/ directly. Production builds require the configured live Clerk publishable key and prepared release assets.
• Web releases use the guarded Deploy current main workflow, pinned to the reviewed commit.
• Catalog publication is separate from a web code release. The pipeline publishes versioned data through manifests; do not regenerate the full catalog just to run the web app.
• Mac releases are separate from web and data releases. menubar/build.sh creates local development builds, not public signed releases. Public macOS distribution requires Developer ID signing and Apple notarization.
• Publishing a new npm package is a separate release step; a web deployment does not publish it.

Security and privacy

The public catalog can be browsed without signing in. Sets have their own access controls; public MCP tools do not expose private account data.

With your approval, the Mac companion scans supported local skill folders and reports inventory to your account. Inventory reports include skill metadata and fingerprints, not full local paths or full skill files. See the privacy policy for details.

Do not commit .env files, API tokens, signing certificates, release credentials or private diagnostic logs. Report security issues privately using SECURITY.md.

License

This repository is source-available, not open source. You may inspect and audit it under the repository license; copying, modifying, redistributing or hosting it requires permission.

The exception is mcp/, which is open source under the MIT License. Third-party skills retain their own licenses and terms.