From 8638b2ab34c3c0574760da954fa44125fe18fb22 Mon Sep 17 00:00:00 2001
From: Necati Ozmen <necatiozmn@gmail.com>
Date: Thu, 29 Jan 2026 16:43:03 +0300
Subject: [PATCH] feat: add contributing guide

---
 CONTRIBUTING.md | 53 +++++++++++++++++++++++++++++++++++++++++++++++++
 README.md       |  6 +++---
 2 files changed, 56 insertions(+), 3 deletions(-)
 create mode 100644 CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..eac96d4
--- /dev/null
+++ 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
diff --git a/README.md b/README.md
index 7821a0e..93d09e8 100644
--- a/README.md
+++ b/README.md
@@ -931,11 +931,11 @@ Priority: Workspace > Local > Bundled
 
 </details>
 
-## Contributing
+## 🤝 Contributing
 
-We welcome contributions!
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
 
-- To add your skill, first publish it to [MoltHub](https://clawdhub.com). After publishing, you'll get a GitHub repository link (e.g., `https://github.com/moltbot/skills/tree/main/skills/username/skill-name`). Then submit a PR to this repo with your skill entry including that link
+- Submit new skills via PR
 - Improve existing definitions
 
 **Note:** Please don't submit skills you created 3 hours ago. We're now focusing on community-adopted skills, especially those published by development teams and proven in real-world usage. Quality over quantity.