excalidraw-pages-deploy

Use when: maintaining this repo's self-hosted Excalidraw GitHub Pages deployment, weekly upstream build workflow, gh-pages snapshot branch, excalidraw.x-ha.com domain docs, or custom font patching. Do not use when: the task is a generic code edit unrelated to Excalidraw, Pages, deployment, or fonts.

Aller à l'installation

Dépôt: owent/tools-excalidraw-self-host
Dernière activité de la source: 5 juillet 2026 à 16:07
Langue détectée de SKILL.md: anglais
Étoiles: 0
Forks: 0

Options d'installation

Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.

npx skills add https://github.com/owent/tools-excalidraw-self-host --skill excalidraw-pages-deploy

La commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.

Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.

Vérifiez les fichiers source

Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.

Explorateur de fichiers

2 fichiers

SKILL.md

Instructions source · Aperçu en lecture seule

Retour à la recherche Retour à l’installation

Excalidraw Pages Deploy

Outcome

Maintain a reproducible static Excalidraw build that publishes to GitHub Pages for excalidraw.x-ha.com and preserves gh-pages as the static snapshot branch.

Workflow

Read AGENTS.md, README.md, docs/deployment/github-pages.md, docs/fonts/custom-fonts.md, and docs/ai/source-index.md.

Verify current upstream docs before changing Excalidraw build commands, GitHub Pages behavior, GitHub Actions versions, or local font-name assumptions.

Keep generated work under build/<task-name>/.

Update config/custom-fonts.json before editing font patch scripts.

When troubleshooting missing custom fonts, inspect the current upstream font picker and registry files before editing: packages/excalidraw/components/FontPicker/FontPickerList.tsx and packages/excalidraw/fonts/Fonts.ts.

Run node scripts/validate-config.mjs after changing workflow, docs, scripts, or font config.

If CI behavior changes, update .github/workflows/deploy-gh-pages.yml, deployment docs, and source index in the same change.

Gotchas

GitHub currently documents that GITHUB_TOKEN commits do not trigger branch-based Pages builds. This repo pushes gh-pages over SSH using the DEPLOY_PAGE_KEY deploy key so Pages actually starts a build.

The repository Pages source must be set to Deploy from a branch → gh-pages / root. Artifact-based deployment is no longer used.

If Pages is not built after a green workflow run, verify the deploy key has Allow write access and that the secret contains the private key (not the public key) before changing Excalidraw build or font patching code.

The workflow intentionally avoids hardcoded toolchain and action release version numbers. Use upstream Excalidraw compatibility metadata, Corepack, and official action default branch refs.

Upstream Excalidraw source layout may change. Inspect the cloned files before changing regex patching logic.

Current upstream font menu entries are rendered from Fonts.registered; adding constants and metadata alone does not make a font selectable.

Do not download or redistribute font files. All custom fonts are local-only local(...) aliases.

Do not invent unnamed artistic fonts. Require exact local font-family names.

Resources

Read references/trigger-eval.md when editing this skill's trigger description.