Skip to content
velonx*SKILLS

Submit a Skill

Every skill lives in velonx/agent-skills on GitHub. Draft your SKILL.md here and we'll hand it to GitHub as a pull request — reviewed in the open, like any other code.

  1. 1Draft

    Fill in the form — it checks the same rules as CI.

  2. 2Open on GitHub

    GitHub forks the repo and opens a pull request.

  3. 3Automated checks

    CI validates the schema, links and safety patterns.

  4. 4Review

    A maintainer reads every file and may ask for changes.

  5. 5Live

    After merge the registry updates and the site rebuilds.

1 · the basics

Folder and id: skills/…/. Filled in from the title.

What it does and when to use it — agents decide from this line alone. 0/1024

Comma-separated, up to 8.

Written for

Permissive licenses only.

The agent needs

2 · the instructions (optional here — you can write them on GitHub)

Prefer the command line?

Fork the repo, add your folder and run the same validator CI runs:

git clone https://github.com/<you>/agent-skills
cd agent-skills && npm install
git checkout -b add-my-skill
mkdir skills/my-skill   # then write skills/my-skill/SKILL.md
npm run validate
git add skills/my-skill && git commit -m "Add my-skill" && git push -u origin add-my-skill

Then open a pull request from your fork. Full walkthrough in the contributing guide and the skill specification.

Before you submit

  • The description says when to use it
  • You tried it with a real agent
  • No secrets, tokens or passwords
  • Irreversible actions ask for confirmation
  • Scripts are readable, not minified
  • You have the right to publish it
What reviewers reject

Have an idea, not a skill?

Describe what you need and someone in the community may build it.

Request a skill