SKILLGENESIS
AI-powered autonomous skill generator for the OpenClaw ecosystem. Create professional skills in seconds.
No configuration. No boilerplate. One command → AI generates, publishes to GitHub, notifies Telegram.
Everything you need to ship skills fast
From AI generation to GitHub publishing to Telegram notifications — Skill Genesis handles the full pipeline autonomously.
Kilo AI Generation
CoreLeverages Kilo CLI to generate rich, specific SKILL.md content — not generic templates. Real commands, real examples, real expertise.
3× Retry Logic
ReliableBuilt-in resilience with 3 attempts and 200s timeout per call. Falls back to a rich category-specific template if AI is unavailable.
Auto-Publish to GitHub
AutomatedCreates the skill repository, uploads SKILL.md (EN + ES), README files, and all assets automatically via GitHub API.
Bilingual by Default
i18nEvery skill is generated in English and Spanish simultaneously — SKILL.md + SKILL.es.md + README.md + README.es.md.
Skills-Hub Integration
EcosystemAutomatically updates the smouj/Skills-Hub manifest.json with the new skill metadata, making it instantly discoverable.
Telegram Notifications
NotifyReal-time alerts via Telegram bot when a new skill is created. Optional — just set TELEGRAM_BOT_TOKEN in your .env.
Lock File Protection
SafeProcess lock mechanism prevents multiple simultaneous executions. PID-based locking with automatic cleanup on stale locks.
Zero Config Auth
DXReads GitHub token from .env or falls back to `gh auth token` automatically. No manual token setup required.
From command to published skill
in 6 automated steps
Run python3 skill_genesis.py and watch the full pipeline execute automatically.
Select a Skill Theme
Skill Genesis randomly picks from 10 predefined themes (seo-audit, code-review, security-scan, etc.) and checks GitHub to ensure the repo doesn't already exist.
Generate with Kilo AI
Sends a rich, specific prompt to Kilo CLI. The AI generates a detailed SKILL.md with real commands, examples, and expertise — not generic placeholders.
Create Bilingual Files
Builds SKILL.md, SKILL.es.md, README.md, and README.es.md — four files covering English and Spanish documentation automatically.
Publish to GitHub
Creates the repository `smouj/{skill-name}-skill`, uploads all files via GitHub API, and makes it immediately public and accessible.
Update Skills-Hub Manifest
Adds the new skill to the manifest.json in smouj/Skills-Hub so it's instantly discoverable by all OpenClaw ecosystem users.
Notify via Telegram
Sends a formatted Telegram message with the skill name and repo URL so you're always in the loop, even running headlessly.
💡 Use --dry-run flag to test the full pipeline without creating any GitHub repos or sending notifications.
10 skills ready to deploy right now
Each skill is a full OpenClaw-compatible agent with bilingual documentation, real CLI commands, and expert-level guidance.
Generate your next skill with a single command:
See it run live
Click the button below to simulate the full Skill Genesis pipeline in your browser.
Press ▶ Run Demo to start simulation...
This is a simulated demo. Real execution requires Python 3, Kilo CLI, and GitHub credentials.
Loved by OpenClaw developers
Developers across the OpenClaw ecosystem are shipping skills faster than ever before.
"Skill Genesis saved me hours. I used to manually write SKILL.md files and publish repos — now I run one command and grab a coffee. The Kilo AI integration is chef's kiss.
"The auto-Telegram notification blew my mind the first time. Ran it at night, woke up to a "New Skill Generated!" message with the GitHub link. Autonomous development is real.
"The bilingual output (EN + ES) is a game-changer for the Spanish-speaking dev community. Two READMEs, two SKILL files, generated in one shot. Incredible.
"The retry logic saved my skin during a Kilo outage. It automatically fell back to the template, which was still super detailed and category-specific. Production-grade reliability.
"I set this as a cron job and it generated 8 skills while I slept. Skills-Hub manifest updated, profile updated, GitHub repos live. This is what autonomous AI should be.
"The security-scan skill it generated has REAL nmap commands, trivy flags, and bandit configurations — not generic placeholders. Kilo actually understands the domain.
Up and running in under 1 minute
No Docker, no complex setup. Just Python, pip, and your GitHub credentials.
Clone the repository
git clone https://github.com/smouj/skill-genesis.git
cd skill-genesis💡 Requires Git and Python 3.8+
Install dependencies
pip install PyGithub requests python-dotenv💡 Or use: pip install -r requirements.txt
Configure environment
cp .env.example .env
# Edit .env with your credentials:
# GITHUB_PAT=ghp_your_token_here
# TELEGRAM_BOT_TOKEN=your_bot_token (optional)
# TELEGRAM_CHAT_ID=your_chat_id (optional)💡 GitHub PAT needs: repo, workflow, admin:repo_hook scopes
Run Skill Genesis
# Full run (creates GitHub repo + notifies Telegram)
python3 skill_genesis.py
# Dry run (test without side effects)
python3 skill_genesis.py --dry-run💡 That's it! Watch the skill get created automatically.
⚙️ Configuration Reference
# .env configuration
GITHUB_PAT=ghp_xxxxxxxxxxxxxxxxxxxx # Required
TELEGRAM_BOT_TOKEN=123456:ABC-xxx # Optional
TELEGRAM_CHAT_ID=@your_channel # Optional
SKILLS_HUB_REPO=smouj/Skills-Hub # Default
SMOUJ_PROFILE_REPO=smouj/smouj # Default⏰ Automate with Cron
# Run every hour via cron (generates one skill per run)
# crontab -e
0 * * * * cd /path/to/skill-genesis && python3 skill_genesis.py >> logs/cron.log 2>&1Ready to generate your first skill?
Join the OpenClaw ecosystem and start shipping AI-powered skills today.
Where we're headed
Skill Genesis is just getting started. Here's the full vision for 2026 and beyond.
Q1 2026
Completed- ✓Initial CLI release with 10 skill themes
- ✓Kilo AI integration with retry logic
- ✓GitHub auto-publish (EN + ES)
- ✓Skills-Hub manifest integration
- ✓Telegram notification system
- ✓Lock file protection
Q2 2026
In Progress- ◐Custom skill theme YAML config
- ◐Discord webhook notifications
- ◐Web dashboard for skill management
- ◐Skill validation & quality scoring
- ◐Multi-account GitHub support
Q3 2026
Planned- ○REST API for remote triggering
- ○GitHub Actions skill generation workflow
- ○Skill dependency graph
- ○Community skill marketplace
- ○VS Code extension integration
Q4 2026
Planned- ○Multi-language skill generation (FR, PT, DE)
- ○AI-powered skill testing & validation
- ○OpenClaw v2 protocol support
- ○Skill analytics dashboard
- ○Enterprise team features
Want to shape the roadmap?
Open an issue on GitHub, join the discussion, or submit a PR. All contributions welcome.