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: Submit via Issue Form (Easiest)

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

Option 2: 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 3: 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.