feat: add contributing guide

2026-03-12 05:35:11 +00:00 · 2026-01-29 16:43:03 +03:00
parent df2721c7bd
commit 8638b2ab34
2 changed files with 56 additions and 3 deletions
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -0,0 +1,53 @@
+# Contributing to Awesome Moltbot Skills
+
+A curated list of skills for Moltbot (formerly Clawdbot). We organize links to skills hosted in the [official Moltbot skills repo](https://github.com/moltbot/skills/tree/main/skills).
+
+## Adding a Skill
+
+### Entry Format
+
+Add your skill to the end of the relevant category in `README.md`:
+
+```markdown
+- [skill-name](https://github.com/moltbot/skills/tree/main/skills/author/skill-name/SKILL.md) - Short description of what it does.
+```
+
+If you have multiple skills under the same author, consolidate them into a single entry linking to your author folder:
+
+```markdown
+- [author-skills](https://github.com/moltbot/skills/tree/main/skills/author) - Brief summary covering all skills.
+```
+
+### Where to Add
+
+- Find the matching category in `README.md` and add your entry at the end of that section.
+- If no existing category fits, add to the closest match or suggest a new category in your PR description.
+
+### Requirements
+
+- Skill must be published to the [Moltbot official skills repo](https://github.com/moltbot/skills/tree/main/skills)
+- Has documentation (SKILL.md)
+- Description must be concise — 10 words or fewer
+- Skill must have real community usage. We focus on community-adopted, proven skills published by development teams and proven in real-world usage. Brand new skills are not accepted — give your skill time to mature and gain users before submitting
+
+### PR Title
+
+`Add skill: author/skill-name`
+
+## Updating an Existing Entry
+
+- Fix broken links, typos, or outdated descriptions via PR
+- If a skill has been removed or deprecated, open an issue or submit a PR to remove it
+
+## Important
+
+- This repository curates links only. Each skill lives in the official Moltbot skills repo.
+- Verify your links work before submitting.
+- We review all submissions and may decline skills that don't meet the quality bar.
+- Do not submit duplicate skills that serve the same purpose as an existing entry.
+
+## Help
+
+- Check existing [issues](https://github.com/VoltAgent/awesome-moltbot-skills/issues) and PRs first
+- Open a new issue for questions
+- Visit the skill's SKILL.md for skill-specific help