⚡ OpenClaw Skill Genesis

AI-Powered Autonomous Skill Generator for the OpenClaw Ecosystem

🌐 Landing Page · ⚡ Quick Start · 📖 Docs · 🗺 Roadmap

---

One command. Full pipeline. AI generates → GitHub publishes → Telegram notifies.

---

🌐 Ver Landing Page → smouj.github.io/skill-genesis

---

🎯 What Is Skill Genesis?

Skill Genesis is an autonomous Python CLI that creates complete, production-ready OpenClaw skills using Kilo AI. Run one command and watch the full pipeline execute:

1. 🎲 Selects a skill theme from 10 battle-tested categories
2. 🧠 Generates rich SKILL.md content via Kilo AI (3× retry, 200s timeout)
3. 📂 Creates bilingual files (EN + ES) — SKILL.md, README, and more
4. 🚀 Publishes a new GitHub repository automatically
5. 📋 Updates the Skills-Hub manifest.json for ecosystem discoverability
6. 🔔 Notifies via Telegram so you're always in the loop

---

⚡ Quick Start

# 1. Clone
git clone https://github.com/smouj/skill-genesis.git
cd skill-genesis

# 2. Install
pip install PyGithub requests python-dotenv

# 3. Configure
cp .env.example .env
# Edit .env: add GITHUB_PAT and optionally TELEGRAM_BOT_TOKEN

# 4. Run!
python3 skill_genesis.py

Test without side effects: python3 skill_genesis.py --dry-run

---

📦 Installation

Prerequisites

Tool	Version	Purpose
Python	3.8+	Runtime
pip	Latest	Package manager
GitHub CLI (gh)	Optional	Auto token detection
Kilo CLI	Latest	AI generation

Install dependencies

pip install PyGithub requests python-dotenv

---

⚙️ Configuration

# .env — copy from .env.example
GITHUB_PAT=ghp_xxxxxxxxxxxxxxxxxxxx      # Required: GitHub Personal Access Token
TELEGRAM_BOT_TOKEN=123456:ABC-xxx        # Optional: Telegram bot notifications
TELEGRAM_CHAT_ID=@your_channel_or_id    # Optional: Where to send notifications
SKILLS_HUB_REPO=smouj/Skills-Hub        # Skills-Hub manifest repo
SMOUJ_PROFILE_REPO=smouj/smouj          # Profile README repo

GitHub PAT Scopes needed: repo, workflow, admin:repo_hook

---

🎮 Generated Skills

Emoji	Skill	Category	Description	Status
🔍	seo-audit	SEO	Technical SEO analyzer — Core Web Vitals, meta, sitemap
💻	code-review	Coding	Comprehensive code quality & security review
🗄	db-optimize	DevOps	PostgreSQL query & index optimizer
🛡	security-scan	Security	Vulnerability scanner with nmap, trivy, bandit
📖	api-docs	Writing	OpenAPI 3.0 / Swagger docs generator
🧪	test-gen	Coding	Unit & integration test generator
📊	log-analyze	Analysis	Log parser & anomaly detector
💾	backup-manager	DevOps	Backup schedule & restore manager
📈	perf-monitor	DevOps	CPU/memory/network performance monitor
☁	cloud-deploy	DevOps	AWS/GCP/Azure deployer with Kubernetes

---

🚀 Usage

# Standard run — creates repo, publishes skill, notifies Telegram
python3 skill_genesis.py

# Dry run — full pipeline simulation without any GitHub/Telegram calls
python3 skill_genesis.py --dry-run

# Automate with cron (every hour)
0 * * * * cd /path/to/skill-genesis && python3 skill_genesis.py >> logs/cron.log 2>&1

---

🔥 Features

Feature	Description
🤖 Kilo AI Generation	Rich, specific SKILL.md — real commands, not placeholders
🔄 3× Retry Logic	Retries with 200s timeout + category-specific fallback template
📦 Auto-Publish	Creates GitHub repo, uploads all files via GitHub API
📝 Bilingual	Generates EN + ES documentation automatically
🌐 Skills-Hub Integration	Updates manifest.json for ecosystem discoverability
🔔 Telegram Alerts	Real-time notifications on skill creation
🔒 Lock File Protection	PID-based locking prevents concurrent runs
⚙️ Zero Config Auth	Auto-detects gh auth token if no .env found

---

🌍 Landing Page

🌐 Live at: smouj.github.io/skill-genesis

The landing page is a Next.js 15 static site in /docs with:

• Dark Cyber-Fantasy theme (#0A0A0A · #8B00FF · #FFD700)
• Interactive canvas particle system + dragon claw animation
• Browser-based CLI demo simulator
• Framer Motion animations throughout
• GitHub Pages auto-deploy via GitHub Actions

---

🤝 Contributing

# 1. Fork & clone
gh repo fork smouj/skill-genesis --clone && cd skill-genesis

# 2. Create a branch
git checkout -b feature/my-improvement

# 3. Test
python3 skill_genesis.py --dry-run

# 4. PR
gh pr create --title "feat: my improvement"

What to contribute: New skill themes · Bug fixes · Documentation · Translations

---

🔔 Telegram Alerts

---

🗺 Roadmap 2026

Quarter	Feature	Status
Q1 2026	Initial release — 10 skills, Kilo AI, GitHub auto-publish	✅ Done
Q2 2026	Custom YAML config, Discord webhooks, Web dashboard	🔄 In Progress
Q3 2026	REST API, GitHub Actions integration, Skill marketplace	📋 Planned
Q4 2026	Multi-language, OpenClaw v2 protocol support	📋 Planned

---

📄 License

MIT © 2026 smouj

---

Built with ⚡ Kilo AI · Part of the OpenClaw Ecosystem

🌐 Landing · ★ Star · 🐛 Bug · 💡 Feature