Skip to content

Skills Wiki — publishing guide

The skills wiki is a MkDocs Material site generated from this repo's SKILL.md files and docs/. It uses the same theme as the other Twycis wikis. GitHub Actions builds it; Cloudflare Pages only hosts the pre-built static site.

How it fits together

core/ variants/ packs/ docs/ README.md   ──►  docs-site/generate.py  ──►  docs-site/build/
                                                        │
                                                  mkdocs build (--strict)
                                                        │
                                                 docs-site/site/  ──►  Cloudflare Pages
  • docs-site/generate.py turns every SKILL.md into a page, renders variant skills as per-flavor tabs, copies companion docs (e.g. reference.md), rewrites in-repo links, and regenerates the nav block inside docs-site/mkdocs.yml.
  • docs-site/build/ and docs-site/site/ are generated and git-ignored.
  • .github/workflows/wiki.yml runs the generator + build, then wrangler pages deploy.

Build locally

cd docs-site
pip install -r requirements.txt
python3 generate.py          # render build/ and refresh mkdocs.yml nav
mkdocs serve                 # preview at http://127.0.0.1:8000
mkdocs build --strict        # what CI runs

One-time Cloudflare Pages setup

  1. Create the project (direct-upload, no Git connection — Actions uploads the build):
npx wrangler pages project create claude-skills-wiki --production-branch=main

Or in the dashboard: Workers & Pages → Create → Pages → Upload assets, name it claude-skills-wiki. (Use a different name only if you also set the CF_PAGES_PROJECT repo variable to match.)

  1. Create an API token: My Profile → API Tokens → Create Token, use the Cloudflare Pages → Edit template (account-scoped). Copy the token.

  2. Find your Account ID: any Workers & Pages page shows it in the right sidebar.

  3. Add the repo secrets (Settings → Secrets and variables → Actions → New repository secret):

Secret Value
CLOUDFLARE_API_TOKEN the token from step 2
CLOUDFLARE_ACCOUNT_ID the account ID from step 3

Optional: add an Actions variable CF_PAGES_PROJECT if your project name isn't claude-skills-wiki.

  1. Push to main (or run the wiki workflow manually via Actions → wiki → Run workflow). The site deploys to https://claude-skills-wiki.pages.dev. Add a custom domain in the Pages project settings if you want one, the same way as the other wikis.

Updating the wiki

Just edit skills under core/, variants/, or packs/ (or docs/) and push to main. The workflow regenerates and redeploys automatically — no manual publish step.