Skip to main content
Back to skills

Contribute a Skill

Built something useful? Share it. Submit your skill to get it listed in the catalog with full attribution.

How it works

1

Create your skill

Write a markdown file that teaches AI assistants a single focused skill—framework knowledge, coding patterns, or tool usage.

2

Submit for review

Fill out the submission form. It opens a GitHub issue with your skill details for review.

3

Review process

Maintainers review your submission for quality, completeness, and fit. Expect feedback or requests for changes.

4

Published

Once approved, your skill gets added to the catalog with full attribution. You'll be credited as the contributor.

Skill template

Use this template structure when submitting your skill. Every field marked in the template is required for a complete submission.

{
  id: 'your-skill-id',
  name: 'Your Skill Name',
  description: 'A brief description of what your skill does.',
  longDescription: 'A more detailed description...',
  category: 'development', // or 'documents', 'creative', 'productivity', 'business'
  tags: ['tag1', 'tag2', 'tag3'],
  icon: '◈',
  color: 'oklch(0.70 0.15 280)',
  features: [
    'Key feature one',
    'Key feature two',
    'Key feature three',
  ],
  useCases: [
    'Example use case one',
    'Example use case two',
    'Example use case three',
  ],
  compatibility: ['gemini', 'claude'],
  version: '1.0.0',
  lastUpdated: '2026-01-27',
  contributor: {
    name: 'Your Name',
    github: 'your-github-username',
  },
}

Category guidelines

Development

Programming, coding tools, testing, DevOps, frameworks, and developer utilities

Documents

PDF, Word, Excel, presentations, and document-processing tools

Creative

Design, art, animation, visual content, and creative coding

Productivity

Task management, automation, workflows, and productivity tools

Business

Strategy, communication, analysis, and enterprise tools

Quality guidelines

  • One clear purpose: Each skill should do one thing well. Combine related features, but don't try to cover everything.
  • Real examples: Include sample prompts and expected outputs so users know what to expect.
  • Tested: Try your skill with both Gemini CLI and Claude Code before submitting.
  • No overlap: Check the existing catalog. If a similar skill exists, consider contributing improvements instead.

View pending submissions

See what skills are being reviewed and track the status of each submission.

View pending submissions

Ready to submit?