skillshare-hub

A curated catalog of skillshare skills — and a reference for building your own.
Search, discover, and install AI CLI skills. Fork this repo to create your organization's internal hub.

What is this?

A curated index of skillshare skills that serves two purposes:

1. Ready-to-use catalog — Pre-configured as the default hub in skillshare. Run skillshare search --hub or open Search > Hub in the Web UI.
2. Reference for your own hub — Fork this repo, replace the skills with your organization's catalog, and customize the CI pipeline. Same schema, same tooling.

Usage

Search via CLI

skillshare search --hub https://raw.githubusercontent.com/runkids/skillshare-hub/main/skillshare-hub.json <query>

Search via Web UI (built-in)

Run skillshare ui, go to Search > Hub — Skillshare Hub is pre-selected. Browse or search the catalog with one-click install.

Install a skill you found

skillshare install <source>

Share Your Skill

Built a useful skill? Share it with the community! Adding your skill to this hub makes it discoverable by all skillshare users — via CLI, Web UI, or direct install.

How to Submit

1. Fork this repo
2. Add your skill to skillshare-hub.json:

   {
     "name": "my-skill",
     "description": "One-line description of what the skill does",
     "source": "your-username/your-repo",
     "tags": ["relevant", "tags"]
   }

3. Open a Pull Request

CI will automatically:

• Validate JSON format, required fields, and naming conventions
• Clone your skill repo and run skillshare audit (security scan)

See CONTRIBUTING.md for full guidelines.

Schema

{
  "schemaVersion": 1,
  "skills": [
    {
      "name": "ascii-box-check",
      "description": "Verify and fix ASCII box-drawing diagram alignment in markdown files",
      "source": "runkids/my-skills",
      "skill": "ascii-box-check",
      "tags": ["docs", "workflow"]
    }
  ]
}

Field	Required	Description
name	Yes	Unique, lowercase, hyphens only
description	Yes	One-line description
source	Yes	GitHub owner/repo, full git URL, or any platform URL (GitLab, Bitbucket, etc.)
skill	No	Specific skill name within a multi-skill repo (used with install -s)
tags	No	1-3 classification tags

Build Your Organization's Hub

Fork this repo to create an internal hub for your team or company. What you get out of the box:

• CI validation — JSON format checks and skillshare audit security scans on every PR
• Contribution workflow — Fork → add entry → PR, with automated gates
• Familiar tooling — Same schema, same CLI, same Web UI

# 1. Fork this repo and replace skills with your internal sources
#    e.g. "source": "ghe.internal.company.com/platform/ai-skills/code-review"

# 2. Or auto-generate an index from installed skills
skillshare hub index -o ./skillshare-hub.json

# 3. Team members add your hub once
skillshare hub add https://skills.internal.company.com/skillshare-hub.json --label company

# 4. Search and install — only accessible behind VPN
skillshare search --hub company

The key advantage: source fields can point to private repos (GitHub Enterprise, internal GitLab, etc.) that public tools like GitHub Search can never reach. Host the JSON file anywhere — internal Git repo, intranet server, S3, file share.

Documentation

• skillshare documentation — full CLI reference and guides
• Hub Index guide — create and manage hub indexes
• CONTRIBUTING.md — how to submit a skill

License

MIT