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.

Ir a la instalación

Repositorio: owent/tools-excalidraw-self-host
Última actividad en el origen: 5 de julio de 2026 a las 16:07
Idioma detectado de SKILL.md: inglés
Estrellas: 0
Forks: 0

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

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

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

Explorador de archivos

2 archivos

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

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.