Publish pipeline

Skill Tibsfox/gsd-skill-creator/examples/skills/media/publish-pipeline

Markdown to HTML/PDF build + FTP sync to configured remote host. Pandoc + xelatex templates, branded output, automated deployment. Proven on 29-document HEL series.From its SKILL.md

Install

npx -y skills add Tibsfox/gsd-skill-creator --skill publish-pipeline

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.

SKILL.md

1.8 KB, 362 tokens by cl100k_base, as published. Nobody here has run it

Publish Pipeline

Activates when research documents need to be converted to publication formats and deployed to the live site.

Build Chain

Markdown (.md) → pandoc → Standalone HTML (branded template)
                       → LaTeX PDF (xelatex, branded template)

Prerequisites

~/.local/bin/pandoc (v3.6+)
xelatex (texlive-xetex)
DejaVu fonts (for PDF)
Templates at the project level: template.tex, html-template.html
build.sh script in the project directory

Build Command

bash www/$SITE_DOMAIN/Research/PROJECT/build.sh

Template Setup

Each research project needs:

template.tex — LaTeX template (branded header/footer, colors, title page)
html-template.html — Standalone HTML template (dark theme, navigation)
build.sh — Iterates research/*.md, builds both formats

FTP Sync

# Full site sync
bash scripts/sync-research-to-live.sh

# Single project sync (direct to FTP root)
lftp -f /tmp/lftp-PROJECT.sh
# Where remote path is /PROJECT (NOT /Research/PROJECT)

Critical: The web server maps $DEPLOY_HOST/Research/X/ to FTP root /X/, not to /Research/X/. Always upload to root-level project directories.

Series Integration

After publishing, add the project to series.js:

{ id: 'CODE', name: 'Project Name', path: 'CODE/index.html' },

Alphabetical insertion by ID.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.