Create Skills

Learn how to create your own Agent Skills and share them with the community.

Overview

An Agent Skill is defined by a SKILL.md file in a GitHub repository. This file contains the prompts, guidelines, and context that enhance AI assistants.

What Makes a Good Skill?

Good skills are:

  • Focused: Address a specific domain or task
  • Clear: Provide unambiguous instructions
  • Practical: Include actionable guidelines
  • Tested: Verified to work with target AI platforms

Quick Start

  1. Create a new GitHub repository
  2. Add a SKILL.md file with your skill content
  3. Submit your skill to the marketplace

Skill Structure

A typical skill includes:

markdown
---
name: My Skill
description: A brief description of what this skill does
version: 1.0.0
author: Your Name
platforms:
  - claude-code
  - codex
  - chatgpt
categories:
  - development
  - productivity
---

# My Skill

## Context
Background information the AI should understand.

## Guidelines
Rules and best practices to follow.

## Examples
Sample interactions demonstrating expected behavior.

Documentation

Examples

Browse real-world skill examples:

Best Practices

Submit Your Skill

Once your skill is ready:

  1. Ensure your repository is public
  2. Visit the Submit page
  3. Enter your repository URL
  4. We'll automatically import your skill

Your skill will be available in the marketplace within 6 hours.