Skip to main content
Back to skills

Contribute a Skill

Built something useful? Share it. Submit your skill and 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 specific skill: framework knowledge, coding patterns, or tool usage.

2

Submit for Review

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

3

Review Process

Maintainers will review your submission for quality, completeness, and fit. You may receive feedback or requests for changes.

4

Published!

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

Skill Template

Use this template structure when submitting your skill. All fields marked in the template are important 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.
  • Actually 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 currently being reviewed and track the status of submissions.

View Pending Submissions

Ready to Submit?