Skip to content

Contributing Guide

Jump to bottom
Leo edited this page Mar 13, 2026 · 1 revision

Contributing Guide

We actively merge community contributions. Two went in just today.

What We're Looking For

Skills

  • New skills that fill gaps in existing categories
  • Python scripts that add runnable tools to existing skills
  • Improvements to existing skill descriptions and workflows
  • Reference documents that add depth to skills

Personas

  • New agent personas with unique perspectives and direct commands
  • Must follow the Personas Overview format
  • Must include at least 3 slash commands

Documentation

  • Wiki pages, tutorials, usage examples
  • Translations

How to Contribute

1. Fork and Branch

git clone https://github.com/YOUR_USERNAME/claude-skills.git
cd claude-skills
git checkout dev
git checkout -b feat/your-feature

Always branch from dev, never from main.

2. Create Your Skill

mkdir -p category/your-skill
# Write your SKILL.md following the Skill Format spec

See Skill Format for the complete specification.

3. Quality Checklist

Before submitting, verify:

  • SKILL.md has proper frontmatter (name, description, license, metadata)
  • Description includes trigger phrases for AI activation
  • Workflow has numbered steps with clear outputs
  • Python scripts use stdlib only (no pip dependencies)
  • No hardcoded secrets, API keys, or credentials
  • SKILL.md is under 200 lines (use references/ for depth)
  • Tested with at least one AI tool (Claude Code, Codex, or Gemini)

4. Submit a PR

git add .
git commit -m "feat(category): add your-skill — brief description"
git push origin feat/your-feature

Open a PR targeting the dev branch.

What Gets Merged Quickly

  • ✅ Skills with runnable scripts (not just instructions)
  • ✅ Clean code following existing patterns
  • ✅ stdlib-only Python (no external dependencies)
  • ✅ Proper frontmatter and trigger phrases
  • ✅ Fills a real gap (check Skills Overview first)

What Gets Requested Changes

  • ⚠️ External dependencies (numpy, requests, etc.) — must use stdlib
  • ⚠️ Binary files in the repo (zip, images, etc.)
  • ⚠️ Skills that duplicate existing ones without clear differentiation
  • ⚠️ Missing frontmatter or vague descriptions

What Gets Rejected

  • ❌ Skills that require paid API keys to function
  • ❌ Malicious code, data exfiltration, or prompt injection
  • ❌ Copied content without attribution
  • ❌ PRs targeting main instead of dev

Code of Conduct

Be respectful, be constructive, be helpful. We're building something together.

Questions?

Open a Discussion or check existing ones.

Clone this wiki locally