Zero-dependency 9-tier GitHub Pages marketing scaffolder, AI-Ready repository delivery generator, and 10-gate SEO / AEO / GEO verification harness.
Turn any open-source repository, developer profile, or organization into a high-converting editorial publication with JSON-LD knowledge graphs, llms.txt discovery, multi-host agent plugin manifests, and 12-section README.md blueprints.
Quickstart · What it makes · Install · How it works · Commands · Limits
Most open-source repositories ship with a barebones README, broken badges, zero AI agent plugin manifests, and no structured metadata for search or LLM answer engines. design-os-github-page codifies both the 9-tier GitHub Pages marketing site and the 5-layer AI-Ready repository delivery standard.
| Dimension | Generic AI / Manual Workflow | DESIGN:OS GitHub Pages Engine (DESIGN:OS) |
|---|---|---|
| Repository Delivery | Prose-only README with missing install manifests or governance files | 5-layer AI-Ready package (.claude-plugin, .codex-plugin, skills/, /doctor, 5-tab governance) |
| README Architecture | Unstructured wall of text or generic boilerplate | 12-Section Editorial Blueprint with jump nav, comparison table, and What loads when |
| Search & AI Discovery | Invisible to ChatGPT Search, Perplexity, and Claude web grounding | 10-gate SEO / AEO / GEO harness (JSON-LD @graph, FAQPage, llms.txt, sitemap.xml) |
| Build Dependencies | Heavy Node/React static-site generators that rot in 6 months | Zero-dependency HTML/CSS + Python stdlib generators that run anywhere in <1s |
| Privacy & Telemetry | Opaque cloud telemetry or unverified third-party APIs | Zero telemetry — 100% local execution (PRIVACY.md audited) |
In Claude Code:
/plugin marketplace add jangtrinh/design-os-github-page
/plugin install design-os-github-page@design-os-github-page
Or from your terminal (Codex, Gemini CLI, Antigravity, OpenCode, or standalone CLI):
git clone https://github.com/jangtrinh/design-os-github-page.git
cd design-os-github-page
python3 scripts/verify-repo-delivery.py . && python3 scripts/seo-aeo-geo-harness.pyOpen your project in your AI coding agent and describe what you need:
"Scaffold a 9-tier editorial GitHub Pages site in docs/ with JSON-LD SoftwareSourceCode + FAQPage schemas and llms.txt."
"Upgrade this repository to the DESIGN:OS 12-section AI-Ready README and generate all plugin manifests and /doctor checks."
"Run the 10-gate SEO, AEO, and GEO verification harness across our ecosystem and fix any missing canonical or OG tags."
python3 scripts/self_check.pyEvery deliverable produced by design-os-github-page is backed by a deterministic verification gate rather than freehand AI guesswork.
Prompt: "Scaffold a 9-tier editorial GitHub Pages site in docs/ with JSON-LD SoftwareSourceCode + FAQPage schemas and llms.txt."
| Deliverable / Mode | Best for | Output Format | Verification Gate |
|---|---|---|---|
| 9-Tier GitHub Pages Site | Launching an editorial product landing page in docs/ or site/ |
HTML5 + CSS + JSON-LD + llms.txt |
scripts/seo-aeo-geo-harness.py (10/10 PASS) |
| AI-Ready Repo Delivery Package | Equipping any repo with multi-agent plugins, /doctor, and 5-tab GitHub governance |
.claude-plugin + skills/ + PRIVACY.md |
scripts/verify-repo-delivery.py (5/5 PASS) |
| Profile & Org READMEs | Upgrading <user>/<user> and .github/profile/README.md with B&W art direction |
Markdown + 2:1 Isometric PNGs |
UKMC.v1 knowledge contract verification |
Choose the setup that matches your AI coding agent. Every option installs the same canonical skill (skills/design-os-github-page/SKILL.md) and /doctor diagnostic suite.
Run these two commands inside Claude Code:
/plugin marketplace add jangtrinh/design-os-github-page
/plugin install design-os-github-page@design-os-github-page
Install to your personal Codex skills directory:
git clone https://github.com/jangtrinh/design-os-github-page.git /tmp/design-os-github-page
mkdir -p ~/.codex/skills/design-os-github-page ~/.codex/prompts
cp -R /tmp/design-os-github-page/skills/design-os-github-page/* ~/.codex/skills/design-os-github-page/
cp /tmp/design-os-github-page/prompts/doctor.md ~/.codex/prompts/design-os-github-page-doctor.md
rm -rf /tmp/design-os-github-pagegit clone https://github.com/jangtrinh/design-os-github-page.git /tmp/design-os-github-page
mkdir -p ~/.gemini/skills/design-os-github-page
cp -R /tmp/design-os-github-page/skills/design-os-github-page/* ~/.gemini/skills/design-os-github-page/
rm -rf /tmp/design-os-github-pagegit clone https://github.com/jangtrinh/design-os-github-page.git /tmp/design-os-github-page
mkdir -p ~/.agents/skills/design-os-github-page
cp -R /tmp/design-os-github-page/skills/design-os-github-page/* ~/.agents/skills/design-os-github-page/
rm -rf /tmp/design-os-github-pageVerify or uninstall
Verify installation:
python3 scripts/self_check.pyOr run /doctor inside Claude Code / Codex to inspect installed skill paths, plugin manifests, and gate health.
Uninstall:
rm -rf ~/.claude/skills/design-os-github-page ~/.codex/skills/design-os-github-page ~/.gemini/skills/design-os-github-page ~/.agents/skills/design-os-github-pageOnce installed, skills/design-os-github-page/SKILL.md activates automatically when your prompt matches its domain triggers. Browse docs/cookbook.md for copy-paste prompt recipes.
Generate & Scaffold
"Scaffold a 9-tier editorial GitHub Pages site in docs/ with JSON-LD SoftwareSourceCode + FAQPage schemas and llms.txt."
Audit & Verify
"Upgrade this repository to the DESIGN:OS 12-section AI-Ready README and generate all plugin manifests and /doctor checks."
Export & Automate
"Run the 10-gate SEO, AEO, and GEO verification harness across our ecosystem and fix any missing canonical or OG tags."
| Command | Environment | What it does |
|---|---|---|
/doctor |
Claude Code / Codex | Read-only diagnostic check of installed skill paths, plugin manifests, and runtime prerequisites |
python3 scripts/self_check.py |
Terminal / CI | Deterministic offline verification of manifests, skill contracts, and governance files |
python3 scripts/scaffold-repo-delivery.py --repo-root . |
Terminal / CI | Scaffold or backfill .claude-plugin, .codex-plugin, skills/, /doctor, governance files, and 12-section README.md |
- Intent Routing — Your AI agent matches your request against
skills/design-os-github-page/SKILL.mdfrontmatter triggers. - Progressive Context Loading — Only the entry-point
SKILL.mdrouter loads initially; detailed recipes and scripts load on demand. - Deterministic Execution — Domain scripts and contracts execute locally with reproducible inputs and outputs.
- Gate Verification —
scripts/self_check.pyand domain verifiers (python3 scripts/verify-repo-delivery.py . && python3 scripts/seo-aeo-geo-harness.py) validate the artifact before completion. - Zero-Telemetry Delivery — Verified files are written directly to your workspace with zero external network calls.
User Prompt / CLI Invocation
│
▼
┌───────────────────────────────────────────────┐
│ skills/design-os-github-page/SKILL.md
│ Progressive disclosure router & hard rules │
└───────────┬───────────────────────────────────┘
│ loads on demand
▼
┌───────────────────────────────────────────────┐
│ python3 scripts/scaffold-repo-delivery.py --repo-root .
│ Deterministic build & contract enforcement │
└───────────┬───────────────────────────────────┘
│ verifies
▼
┌───────────────────────────────────────────────┐
│ python3 scripts/self_check.py + /doctor │
│ Zero-telemetry local verification gate │
└───────────────────────────────────────────────┘
design-os-github-page uses progressive context disclosure so your agent's context window stays fast and focused:
| File | Loaded when |
|---|---|
skills/design-os-github-page/SKILL.md |
Always (~100–150 lines) — routing rules, triggers, and execution workflow |
docs/cookbook.md |
When selecting multi-step prompt recipes or domain patterns |
commands/doctor.md / prompts/doctor.md |
Only when running /doctor diagnostics |
llms.txt |
When indexed by AI answer engines, RAG pipelines, or repo crawlers |
design-os-github-page/
├── .claude-plugin/
│ ├── plugin.json # Claude Code plugin manifest
│ └── marketplace.json # Claude Code marketplace catalog
├── .codex-plugin/
│ └── plugin.json # OpenAI Codex plugin & interface manifest
├── .agents/
│ └── plugins/marketplace.json # Cross-agent local plugin registry
├── .factory-plugin/
│ ├── plugin.json # Factory / Droid plugin manifest
│ └── marketplace.json # Factory marketplace metadata
├── skills/
│ └── design-os-github-page/
│ └── SKILL.md # Canonical agent skill entrypoint
├── commands/
│ └── doctor.md # /doctor diagnostic slash command
├── prompts/
│ └── doctor.md # Codex diagnostic prompt mirror
├── scripts/
│ └── self_check.py # Deterministic repository & skill self-check
├── docs/
│ ├── cookbook.md # Copy-paste prompt recipes by job
│ └── llms.txt # GEO / LLM discovery index
├── PRIVACY.md # Zero-telemetry & local-first privacy commitment
├── SECURITY.md # Vulnerability disclosure & security policy
├── CONTRIBUTING.md # Contribution workflow & verification rules
├── CODE_OF_CONDUCT.md # Contributor Covenant code of conduct
├── CHANGELOG.md # Release history
├── llms.txt # Root LLM indexing manifest
├── LICENSE # PolyForm Shield 1.0.0
└── README.md
python3 scripts/self_check.pyprintsok: design-os-github-page self-check passed (design-os-github-page)and exits0.python3 scripts/verify-repo-delivery.py . && python3 scripts/seo-aeo-geo-harness.pypasses with zero contract or test regressions.- Your AI coding agent loads
skills/design-os-github-page/SKILL.mdautomatically when given any prompt fromdocs/cookbook.md. - Network traffic during execution remains zero (guaranteed by
PRIVACY.md).
- Dynamic multi-tenant web applications requiring server-side databases or authenticated user sessions.
- Private internal scratchpads that should never be indexed by search engines or AI answer engines.
- Heavy interactive 3D/video showcases where a dedicated runtime (
design-os-svg-animationordesign-os-3d-blender) is needed.
design-os-github-page is one of the 13 source-available engines in the DESIGN:OS ecosystem:
Built by Jang Trịnh. More projects, case studies and writing at jang.work.
- Contributing: See
CONTRIBUTING.mdfor pull request guidelines and verification gates (python3 scripts/self_check.py). - Code of Conduct: Governed by
CODE_OF_CONDUCT.md. - Security & Privacy: Zero telemetry — see
SECURITY.mdandPRIVACY.md. - Changelog & LLM Index: Track releases in
CHANGELOG.mdand machine-readable index inllms.txt. - License: PolyForm Shield 1.0.0 © Jang Trinh. Free to use and modify, including for paid client work; you may not resell it or build a competing product from it.
If design-os-github-page saves you time, a star on GitHub helps other engineers and AI agents find it.
