User Guide

This marketplace is intentionally strict: we only index repositories that publish Skills as canonical SKILL.md files under skills/*/SKILL.md or .claude/skills/*/SKILL.md. That is how we avoid “random OSS repos” and keep the catalog useful.

What Are Skills?

A Skill is a reusable, installable capability for an agent. In this project, a Skill is defined by a single SKILL.md document (with YAML frontmatter + body) stored in a canonical folder layout.

Creating Skills

Create a public GitHub repository that is dedicated to Skills (recommended), then add one or more SKILL.md files using one of the canonical layouts below.

skills/my-skill/SKILL.md
.claude/skills/my-skill/SKILL.md

Writing SKILL.md

We parse YAML frontmatter and validate a small set of quality rules so broken or incomplete docs do not enter the public catalog.

---
name: My Skill
description: One-line description that explains what the skill does.
category: Tools
---

## Overview
Explain what it does, inputs/outputs, and how to use it.

Advanced Features

Add concrete examples, constraints, and triggers in a consistent format. The goal is to make Skills searchable, comparable, and safe to reuse.

Collections (Planned)

We plan to support “Collections” (curated sets of Skills) so teams can share a bundle that works well together.

Troubleshooting

If your Skill is not showing up, check these common issues:

  • Not using the canonical path (skills/*/SKILL.md)
  • Broken or missing YAML frontmatter
  • Missing description field