Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
42 lines (26 loc) · 1.85 KB

CONTRIBUTING.md

File metadata and controls

42 lines (26 loc) · 1.85 KB
Raw

Contributing to Awesome AI Agent Skills

Thank you for your interest in contributing to this collection. We welcome new skills, improvements to existing ones, and bug fixes from the community.

How to Add a New Skill

  1. Fork the repository and clone it to your local machine.

  2. Choose the right category. Browse the existing categories in the repository and select the one that best fits your skill. If no existing category fits, you may propose a new one.

  3. Create the skill directory. Inside the appropriate category folder, create a new directory for your skill. The directory name must use kebab-case (lowercase letters, numbers, and hyphens only).

  4. Create the SKILL.md file. Every skill must include a SKILL.md file with the following structure:

---
name: your-skill-name
description: A clear description of what the skill does and when to use it.
license: MIT
---

# Your Skill Name

Detailed instructions, workflows, and examples for the agent.

  1. Add optional resources. If your skill requires scripts, reference documentation, or templates, add them in the appropriate subdirectories (scripts/, references/, assets/).

  2. Submit a pull request. Push your changes to your fork and open a pull request against the main branch.

Skill Quality Guidelines

We prioritize quality over quantity. Please ensure your skill meets the following criteria:

  • Clear and actionable instructions. The agent should be able to follow the instructions without ambiguity.
  • Practical examples. Include at least one example of how the skill is used.
  • Proper YAML frontmatter. The name and description fields are required.
  • Tested and validated. If possible, test your skill with an AI agent before submitting.

Code of Conduct

Be respectful and constructive in all interactions. We are building this together.