Claude Code / Hermes / Codex skill

README to deployed GitHub Pages in one guided session.

A reusable skill that reads a project README, runs a Stitch MCP design pass, authors a static docs/index.html, enables GitHub Pages, commits, pushes, and verifies the live URL.

landing-flow.log
$ read README.md LICENSE docs/*
# extract positioning, quickstart, visuals
$ stitch.generate_screen_from_text
screen ready: design tokens + HTML reference
$ write docs/index.html docs/.nojekyll
$ gh api repos/<owner>/<repo>/pages
verify: Pages build built + live curl 200

What it does

Turns repo context into a shareable landing page.

The skill packages the repeated work behind a polished project homepage: design direction, static HTML, GitHub Pages setup, and proof that the hosted page is actually live.

01

Reuse real copy

Ports README taglines, feature names, quickstart commands, screenshots, license, and repository links instead of inventing marketing text.

02

Design with Stitch MCP

Uses Stitch as the design pass, then extracts useful tokens and structure into a maintainable static page.

03

Ship with proof

Enables Pages from main and /docs, sets the homepage, polls the Pages build, and curls the final URL.

Eight phases

A repeatable build, host, verify pipeline.

Read repoREADME, license, screenshots, existing Pages files.
Generate designCreate a Stitch project and desktop screen from the repo context.
Inspect outputDownload the Stitch HTML and extract design tokens, not placeholder assets.
Author pageWrite one production docs/index.html with semantic landmarks.
Disable JekyllAdd docs/.nojekyll so Pages serves files exactly.
Enable PagesConfigure GitHub Pages for main and the /docs folder.
Commit and pushShip the static page through git, with a PR fallback if main is protected.
Verify liveCheck latest build status, HTTP 200, and expected content on the live URL.

Install

Drop the skill into your agent runtime.

Requires Stitch MCP authentication, gh CLI auth, and push access to the target repository.

Claude Code

User-level skill directory.

git clone https://github.com/cskwork/stitch-landing-skill \
  ~/.claude/skills/stitch-landing

Hermes

Category-based skill layout.

git clone https://github.com/cskwork/stitch-landing-skill \
  ~/.hermes/skills/productivity/stitch-landing

Codex CLI

Same SKILL.md format; copy or symlink.

cp -R stitch-landing-skill \
  ~/.codex/skills/stitch-landing

Verification first

The deliverable is not done until the URL is live.

The included helper scripts make Pages setup and live checks repeatable for each target repo.

verify-pages.sh
$ ./scripts/enable-pages.sh owner/repo
source: main /docs
$ ./scripts/verify-pages.sh owner/repo "<title>"
pages build: built
live: https://owner.github.io/repo/

Reference

Study the source and example output.