Back to Learn

Skill Catalogs

Catalogs are curated collections of certified skills. They provide trust, discoverability, and version management for skills across teams and the community.

Types of Catalogs

Personal Collection

Your private workspace for skills you're developing or have saved. Only you can see these. Not published to any catalog.

PrivateDrafts allowedNo approval needed

Organization Catalog

Skills shared within your organization. Can contain private skills (org members only) or public skills (visible to everyone but managed by the org).

Private skills Public skillsAdmin approvalGitHub-backed

SkillMill Public Catalog

The official public catalog of certified skills. Curated by SkillMill, available to everyone. Skills here have passed safety and quality reviews.

Public CertifiedSkillMill reviewGitHub-backed

Fork & Version Model

When a skill is published to a catalog, it's forked (copied), not referenced. This ensures:

  • 1.
    Stability

    Changes to the source don't break published skills

  • 2.
    Version Control

    Each catalog version is a specific snapshot with a version stamp

  • 3.
    Origin Tracking

    We track where the skill came from (source repo, commit SHA)

Important: Updates require explicit republication. If you update your source skill, you must submit a new version request.

Publishing Flows

PersonalOrg Catalog

Submit your skill for internal publication. An org admin reviews and approves. Skill is copied to your org's GitHub-backed catalog.

Org CatalogPublic Catalog

Promote an org-certified skill to the public catalog. SkillMill reviews against public standards. Both catalogs maintain independent versions.

PersonalPublic Catalog
(Individual contributors)

Individual contributors (not in an org) can publish directly to the public catalog. Skills are namespaced under your GitHub username.

Wild (GitHub)Org/Public

"Wild" skills are discovered on GitHub but not yet managed. A verified user can submit them for validation and publish to either catalog.

Namespace & Ownership

All published skills use the format: vendor/skill-name

Organizations

Use their verified org name (e.g., anthropic/document-skills). Verified via email domain.

Individual Contributors

Use their GitHub username (e.g., jeffrschneider/pdf-tools). Verified via GitHub OAuth.

GitHub Integration

Catalogs are backed by GitHub repositories for version control, audit trails, and collaboration.

Public Catalog

skillmill-ai/agent-skills-catalog

All certified public skills live here

Organization Catalogs

{org}/skillmill-skills-catalog

Created in your org's GitHub, managed by SkillMill

Access & Visibility

Private Skills Stay Private

Private org skills are only accessible to verified members of that organization. There is no cross-org private sharing—if you want another org to use your skill, publish it to the public catalog.

To share across organizations: Promote your private skill to the public catalog. Both organizations can then install it.

UNKNOWN ENV