Publish a Skill

Skills are built to serve use cases. Fork the repo, add your SKILL.md, and open a pull request.

Start with a use case first? Go to Publish a Use Case

How it works

Step 1

Fork & Clone

Fork the skills repository and create a new branch.

Step 2

Create SKILL.md

Add your skill file using the template below.

Step 3

Open Pull Request

Push your branch and open a PR. The template will auto-fill.

Fork the Repository Open Pull Request

SKILL.md Template

Copy this template and fill in your skill details.

SKILL.md

---
name: your-skill-name
description: >-
  What it does and when to use it. Include trigger words so the AI knows
  when to activate. Max 1024 characters. Written in third person.
license: Apache-2.0
compatibility: "e.g., Requires Python 3.9+ or No special requirements"
metadata:
  author: your-github-username
  version: "1.0.0"
  category: development
  tags: ["tag1", "tag2", "tag3"]
---

# Skill Name

## Overview
Brief description of what this skill enables (2-3 sentences).

## Instructions
1. First step — tell the agent exactly what to do
2. Second step — be specific and actionable
3. Third step — include code or concrete procedures

## Examples

### Example 1: Descriptive title
**User request:** "Example prompt the user would say"

**Actions taken:**
- Step-by-step what the agent does
- With realistic data, not lorem ipsum

**Output:**
\`\`\`
Expected output here
\`\`\`

### Example 2: Another scenario
**User request:** "Another example prompt"

**Actions taken:**
- Different scenario to show versatility

**Output:**
\`\`\`
Expected output here
\`\`\`

## Guidelines
- Best practice for this skill
- Common edge case and how to handle it
- Error scenario and expected behavior

Submission Checklist

0/14

Verify your skill meets all requirements before submitting.

Ready to submit?

Push your branch and open a pull request. Our PR template will guide you through the final steps.

Create Pull Request Full Contributing Guide