Agent Skill

skill-site-generator

Turn any SKILL.md into a polished landing page.

One sentence to your agent, and it reads your skill, writes bilingual copy, generates HTML with SEO and OG assets, and deploys to GitHub Pages. This very page was built by the skill itself.

$ npx skills add eze-is/skill-site-generator
See what it can do
6 steps, fully automated
EN/中 bilingual out of the box
1 command to deploy
Agent Terminal
> |
your-skill.github.io

Works with

Claude Code
Cursor
Gemini CLI
Codex CLI
Kilo Code
Any SKILL.md agent

Great skills deserve a front door.

You built an amazing skill. But without a landing page, nobody discovers it, nobody understands what it does, and nobody installs it.

Without skill-site-generator
  • A raw SKILL.md on GitHub is your only "homepage"
  • No SEO — search engines can't find your skill
  • No OG image — shared links look bland on social media
  • Writing bilingual copy and HTML from scratch takes hours
  • Deploy? You still need to set up GitHub Pages manually
With skill-site-generator
  • Polished landing page generated from your SKILL.md
  • Full SEO: structured data, sitemap, robots.txt, canonical URL
  • OG image auto-generated with skill name, stats, and preview
  • Bilingual EN/中 copy written by your agent in seconds
  • One-command deploy to GitHub Pages — done in 30 seconds

Read. Generate. Deploy.

Your agent reads the target SKILL.md, understands what it does, generates a complete static site with bilingual content, and pushes it to GitHub Pages. No manual steps.

SKILL.md
Your skill's source of truth
Read & Analyze
AI Agent
Content + HTML generation
Write & Deploy
GitHub Pages
Live website, custom domain

Read

Parse SKILL.md, fetch GitHub stars/forks, understand the skill's purpose and capabilities

Generate

Write bilingual copy, produce HTML + JS, create favicon, OG image, SEO files

Deploy

Push to gh-pages branch, enable GitHub Pages, optional custom domain via CNAME

Everything from SKILL.md to live website.

Intelligent Copywriting

Reads your SKILL.md and writes landing page copy that follows a problem-solution-effect narrative. Not a feature list — a story that makes developers install.

> "Generate a website for my web-access skill"

Bilingual i18n

Every text element gets EN/中 translations baked into the JS. Users toggle languages with one click — no page reload, no separate builds.

> "Make the site bilingual English and Chinese"

Production-Ready HTML

Generates semantic HTML with structured data, Open Graph tags, Twitter Cards, favicon links, and a responsive design that works on all devices.

> "Include SEO metadata and social sharing cards"

Auto Asset Generation

Generates SVG/PNG favicons, a 1200x630 OG social image, robots.txt, and sitemap.xml. All from a single script invocation with your skill's branding.

> "Generate all assets with #e84393 as brand color"

One-Click Deploy

Pushes the generated site to a gh-pages branch and enables GitHub Pages. Custom domain? Just provide a CNAME — it handles the rest.

> "Deploy to GitHub Pages with custom domain skill.eze.is"

Meta Recursion

This skill generates websites for skills — including itself. This page is living proof. The ultimate dogfooding: if it can sell itself, it can sell anything.

> "Generate a website for skill-site-generator itself"

One sentence. One website.

1

Install the skill

npx skills add eze-is/skill-site-generator
2

No configuration needed

The skill works out of the box. It carries its own templates, scripts, and content guide — nothing to configure.

3

Tell your agent to build

Say something like "Generate a landing page for my-skill" — the skill activates, reads the SKILL.md, and outputs a complete website.

Requirements

Node.js 22+ GitHub CLI (gh) A public GitHub repo for the target skill

Frequently Asked Questions

Does it only work with Claude Code skills?

No. It generates websites for any SKILL.md-based skill, regardless of which agent harness runs it — Claude Code, Cursor, Gemini CLI, Codex CLI, etc.

Can I customize the generated website?

The output is plain HTML + CSS + JS — all static files you fully own. Edit anything after generation. The shared CSS template provides a polished baseline; you can override or replace it.

Wait, this page was generated by the skill itself?

Yes. This is skill-site-generator generating its own landing page. It read its own SKILL.md, wrote the bilingual copy, produced the HTML, and generated all assets. If it can sell itself, it can sell your skill too.

How does the bilingual support work technically?

All text elements use data-i18n attributes. The script.js contains an i18n object with en/zh translations. A toggle button switches languages instantly — no reload, no separate pages, no build step.

What if my skill is very simple or very complex?

The content guide adapts: lightweight skills get fewer sections (Hero + Problem + Capabilities + Install), while complex multi-component skills get the full treatment including architecture diagrams and API references. Sections match the skill's actual complexity.

Does deployment require any manual setup?

No. The deploy script uses gh CLI to push to a gh-pages branch and enable GitHub Pages automatically. For custom domains, just pass a CNAME value — the script creates the file and deploys it with the site.