Contribute a Skill

Thank you for contributing to AI Research Skills! There are several ways to add new skills - choose the one that works best for you.

Option 1: Add Skill Portal (Recommended)

Use our guided web portal for the easiest contribution experience. Preview your skill before submitting, and a PR is created automatically.

Features:

• Guided form with live preview
• SKILL.md generated automatically
• Pull request created on submit
• No GitHub account required for preview

Option 2: Submit via Issue Form

No Git knowledge required! Fill out a simple form and we'll convert it to a skill.

Option 3: Edit on GitHub (Easy)

Use GitHub's web interface to add a skill directly - no local setup needed.

Steps:

1. Go to the skills directory
2. Navigate to the appropriate category folder (research/ or analysis/)
3. Click Add file → Create new file
4. Name your file: your-skill-name/SKILL.md
5. Copy the template and fill in your content
6. Click Propose new file to create a Pull Request

Option 4: Full Git Workflow (Advanced)

For those comfortable with Git:

# Clone the repository
git clone https://github.com/boan-anbo/ai-research-skills.git
cd ai-research-skills

# Create a new branch
git checkout -b add-skill-your-skill-name

# Copy the template
mkdir -p skills/research/your-skill-name
cp skills/_template/SKILL.md skills/research/your-skill-name/

# Edit your skill
# ... edit the file ...

# Validate
npm install
npm run validate

# Commit and push
git add .
git commit -m "Add skill: your-skill-name"
git push -u origin add-skill-your-skill-name

# Open a Pull Request on GitHub

Skill Requirements

Every skill must include:

See the Taxonomy for full field specifications and tag conventions.

Questions?

Open an issue if you have questions about contributing.