Powered by Kilo AI · OpenClaw Ecosystem
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.

⚡Get Started (1 min)★Star on GitHub
⚡
10+
Skills Ready
🔄
3×
AI Retry Logic
⏱
200s
Kilo Timeout
✨
∞
Possibilities
SCROLL↓
⚡ Features
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

Core

Leverages Kilo CLI to generate rich, specific SKILL.md content — not generic templates. Real commands, real examples, real expertise.

🔄

3× Retry Logic

Reliable

Built-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

Automated

Creates the skill repository, uploads SKILL.md (EN + ES), README files, and all assets automatically via GitHub API.

📝

Bilingual by Default

i18n

Every skill is generated in English and Spanish simultaneously — SKILL.md + SKILL.es.md + README.md + README.es.md.

🌐

Skills-Hub Integration

Ecosystem

Automatically updates the smouj/Skills-Hub manifest.json with the new skill metadata, making it instantly discoverable.

🔔

Telegram Notifications

Notify

Real-time alerts via Telegram bot when a new skill is created. Optional — just set TELEGRAM_BOT_TOKEN in your .env.

🔒

Lock File Protection

Safe

Process lock mechanism prevents multiple simultaneous executions. PID-based locking with automatic cleanup on stale locks.

⚙️

Zero Config Auth

DX

Reads GitHub token from .env or falls back to `gh auth token` automatically. No manual token setup required.

See it in action →
🗺 How It Works
From command to published skill
in 6 automated steps

Run python3 skill_genesis.py and watch the full pipeline execute automatically.

STEP 01🎲

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.

slug, name, category, purpose, tags = random.choice(SKILL_THEMES)
STEP 02🧠

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.

kilo run "Generate SKILL.md for: {name}..." --timeout 200
STEP 03📂

Create Bilingual Files

Builds SKILL.md, SKILL.es.md, README.md, and README.es.md — four files covering English and Spanish documentation automatically.

files = create_skill_files(slug, name, category, purpose, content)
STEP 04🚀

Publish to GitHub

Creates the repository `smouj/{skill-name}-skill`, uploads all files via GitHub API, and makes it immediately public and accessible.

repo = user.create_repo(name=repo_name, private=False)
STEP 05📋

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.

repo.update_file("manifest.json", f"Add skill: {slug}", ...)
STEP 06🔔

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.

requests.post(f"api.telegram.org/bot{token}/sendMessage", json={...})

💡 Use --dry-run flag to test the full pipeline without creating any GitHub repos or sending notifications.

⚡ Skills Gallery
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.

🔍

SEO Audit

seoReady

Analyzes websites for technical SEO issues — Core Web Vitals, meta tags, sitemap, robots.txt.

#audit#keywords#ranking
→/seo-audit-skill
💻

Code Review

codingReady

Comprehensive code review covering quality, security vulnerabilities, and best practices.

#review#quality#security
→/code-review-skill
🗄

DB Optimizer

devopsReady

Optimizes PostgreSQL queries, indexes, and schema for maximum performance.

#database#postgres#queries
→/db-optimize-skill
🛡

Security Scanner

securityReady

Scans for security vulnerabilities using nmap, trivy, bandit and industry-standard tools.

#security#CVE#scan
→/security-scan-skill
📖

API Docs

writingReady

Generates OpenAPI 3.0 / Swagger documentation from code with real endpoint examples.

#api#openapi#swagger
→/api-docs-skill
🧪

Test Generator

codingReady

Creates unit and integration tests from existing code — Jest, Pytest, Vitest support.

#tests#coverage#jest
→/test-gen-skill
📊

Log Analyzer

analysisReady

Parses application logs to identify errors, anomalies, and performance patterns.

#logs#errors#debugging
→/log-analyze-skill
💾

Backup Manager

devopsReady

Manages automated backup schedules, restoration procedures, and data integrity checks.

#backup#restore#schedule
→/backup-manager-skill
📈

Perf Monitor

devopsReady

Monitors CPU, memory, disk, and network metrics with alerting thresholds.

#performance#cpu#memory
→/perf-monitor-skill
☁

Cloud Deployer

devopsReady

Deploys to AWS, GCP, and Azure with Docker and Kubernetes orchestration support.

#deploy#cloud#aws
→/cloud-deploy-skill

Generate your next skill with a single command:

$python3 skill_genesis.py
▶ Interactive Demo
See it run live

Click the button below to simulate the full Skill Genesis pipeline in your browser.

skill-genesis — python3 skill_genesis.py

Press ▶ Run Demo to start simulation...

0/17 steps

This is a simulated demo. Real execution requires Python 3, Kilo CLI, and GitHub credentials.

💬 Testimonials
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.

AR
Alejandro Ruiz
@alexdev_oc · OpenClaw Core Contributor
★★★★★

"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.

MF
María Fernández
@mafe_codes · DevOps Engineer @ TechLatam
★★★★★

"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.

CM
Carlos Mendoza
@cmendoza_ai · AI Researcher, OpenClaw Ecosystem
★★★★★

"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.

VT
Valentina Torres
@val_fullstack · Full-Stack Dev & OpenClaw User
★★★★★

"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.

DG
David García
@dg_automation · Automation Specialist
★★★★★

"The security-scan skill it generated has REAL nmap commands, trivy flags, and bandit configurations — not generic placeholders. Kilo actually understands the domain.

SL
Sofía López
@sofia_secdev · Security Engineer
★ 4.9/5
Average rating
200+
Skills generated
50+
OpenClaw developers
⚡ Quick Start
Up and running in under 1 minute

No Docker, no complex setup. Just Python, pip, and your GitHub credentials.

1

Clone the repository

step-1.sh
git clone https://github.com/smouj/skill-genesis.git
cd skill-genesis

💡 Requires Git and Python 3.8+

2

Install dependencies

step-2.sh
pip install PyGithub requests python-dotenv

💡 Or use: pip install -r requirements.txt

3

Configure environment

step-3.sh
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

4

Run Skill Genesis

step-4.sh
# 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
# .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

crontab
# 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>&1

Ready to generate your first skill?

Join the OpenClaw ecosystem and start shipping AI-powered skills today.

★ Star on GitHub🐛 Report an Issue
🗺 Roadmap 2026
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.

💡 Suggest Feature📋 Contributing Guide