How to Create Your First AI Agent Skill

Why Create Custom Skills?

The skills in our directory are great, but **your workflow is unique**. Creating a skill lets you package your expertise into something reusable.

Anatomy of a Skill

Every skill is a directory with this structure:

my-awesome-skill/
├── SKILL.md          # Main configuration & documentation
├── scripts/          # Helper scripts (optional)
├── data/             # Static data (optional)
└── assets/           # Images, templates (optional)

Step-by-Step: Creating a "Code Reviewer" Skill

Step 1: Create the Directory

mkdir -p code-reviewer
cd code-reviewer

Step 2: Write SKILL.md

# Code Reviewer Skill

## What It Does
Performs systematic code reviews following your team's standards.

## When to Use
Before submitting PRs, after major refactoring, or during peer review.

## Standards Checklist

### Code Quality
- [ ] Variable naming follows conventions
- [ ] Functions are small and do one thing
- [ ] No magic numbers or strings

### Security
- [ ] No hardcoded secrets
- [ ] Input validation present
- [ ] SQL injection prevention

Step 3: Add Helper Scripts

#!/bin/bash
# Quick security scan
echo "🔍 Running security checks..."

Step 4: Test Your Skill

claude "Review this function using the Code Reviewer skill"

Best Practices

1. **Be Specific, Not Generic**

❌ Bad: "Write good code"

✅ Good: "Check that all API calls have timeout handling"

2. **Include Checklists**

Checklists force systematic thinking.

3. **Make It Platform-Avoidant**

Write prompts that work across Claude, Cursor, and Antigravity.

Submit Your Skill to Antigravity

1. Fork our [skills-directory repo](https://github.com/bodhi584/skills-directory)

2. Add your skill to the `data/` directory

3. Create a PR

4. Our team will review and publish

What's Next?

1. Browse AntigravitySkills.org for inspiration

2. Identify a repetitive task in your workflow

3. Package it as a skill

4. Share it with the community

The best skills come from solving your own problems.