The Digital Futurist logoSkills and Prompt Registry
type guideowner Thomas Cherickalcurator Thomas Cherickalupdated 2026-11-15

Deploy the Free Public Registry to Cloudflare Pages

Target: https://skillregistry.thedigitalfuturist.com

This repo builds a static site from its Markdown files. Every page, wikilink and metadata field turns into HTML. The site also gets a client-side search ranked by stars. The Cloudflare Pages free plan covers it.

What Is in the Repo

Path Purpose
00-setup/ to 04-public-skills-directory/ The registry content (Markdown, Obsidian-compatible)
site/build_site.py Converts Markdown to HTML in public/, rewrites wikilinks, builds search.json
site/template.html, site/assets/style.css Page layout, dark theme, gold links
site/assets/logo.png Add your Digital Futurist logo here (PNG, about 72px tall). If the file is missing, the header shows text only
site/_headers Security and cache headers for Cloudflare
requirements.txt, .python-version Python build setup for Cloudflare

Step 1 - Test Locally

pip install -r requirements.txt
python site/build_site.py
python -m http.server 8000 --directory public

Open http://localhost:8000 and check the home page, a role page and search.

Step 2 - Push to GitHub

git init
git add .
git commit -m "Skills and Prompt Registry v0.1.0"
git branch -M main
git remote add origin https://github.com/<your-account>/skill-registry.git
git push -u origin main

public/ is in .gitignore. Cloudflare builds it fresh on every push.

Step 3 - Create the Pages Project

  1. Open the Cloudflare dashboard and go to Workers & Pages. Select Create, then Pages, then Connect to Git.
  2. Select the skill-registry repository.
  3. Use these build settings:
Setting Value
Framework preset None
Build command pip install -r requirements.txt && python site/build_site.py
Build output directory public
Root directory (leave empty)
  1. Select Save and Deploy. The first build publishes the site at https://<project>.pages.dev.

Cloudflare's v3 build image includes Python and pip. The .python-version file pins Python 3.12. You can override it with a PYTHON_VERSION environment variable.

Step 4 - Add the Custom Subdomain

  1. In the Pages project, open Custom domains and select Set up a domain.
  2. Enter skillregistry.thedigitalfuturist.com and select Continue.
  3. Point DNS at the site: - If thedigitalfuturist.com uses Cloudflare DNS: confirm, and Cloudflare creates the CNAME record for you. - If DNS is with another provider: create a CNAME record with name skillregistry and target <project>.pages.dev.
  4. Wait for the domain to show Active. SSL is issued automatically.

Order matters: add the domain in the Pages dashboard before you create the CNAME record. If you create the record first, the domain fails to resolve and shows a 522 error.

Step 5 - Updating the Registry

Optional: Deploy Without Git

pip install -r requirements.txt && python site/build_site.py
npx wrangler pages deploy public --project-name skill-registry

Keeping the Demo Public-Safe

Sources