skills.surf

Submit Your Skills

Share your agent skills with the community by adding your repository to our registry.

Requirements

  • 1.Your repository must be public on GitHub
  • 2.Each skill must have a SKILL.md file with YAML frontmatter
  • 3.Required frontmatter fields: name and description
  • 4.Optional fields: license, compatibility, metadata

Example SKILL.md

---
name: my-skill-name
description: Brief description of what this skill does and when to use it
license: MIT
---

# My Skill Name

Detailed instructions for the AI agent on how to use this skill.

## When to Use

Describe the scenarios when this skill should be activated.

## Instructions

Step-by-step guidance for the agent.

How to Submit

  1. 1.
    Fork our registry repository

    Clone the 851-labs/skills repository

  2. 2.
    Add your repository to registry-sources.json

    Add an entry with your GitHub owner, repo name, branch, and the path to your skills folder

  3. 3.
    Create a pull request

    We'll review your submission and merge it if it meets our guidelines

Registry Source Format

{
  "owner": "your-github-username",
  "repo": "your-repo-name",
  "branch": "main",
  "skillsPath": "skills"
}

The skillsPath is the directory containing your skill folders. Each subfolder should contain a SKILL.md file.

Ready to submit?

Open a pull request to add your repository to the registry

Edit registry-sources.json