stencil.pub

The community-owned journal of physics simulation, hosted at stencil.pub (and pre-domain at stencil-pub.github.io/stencil.pub).

Companion to the Claude plugin at stencil-pub/stencil, which the website reads at build time to render the /plugin skill registry.

Local development

npm install
npm run dev

npm run dev (and npm run build) automatically runs npm run skills:sync, which shallow-clones the plugin repo into .skills-tmp/ so the registry pages have data. If the plugin repo is unreachable, the build still succeeds with an empty registry.

Architecture

• Astro v6, content layer API, static output, GitHub Pages.
• Articles live in src/content/articles/*.mdx (zod-validated).
• Skills live in the plugin repo's skills/*.md; the website fetches them at build time. The plugin repo's CI dispatches a skills-updated event to this repo on every merge to main, which triggers a rebuild here within ~1 minute.
• No third-party services beyond DNS. No backend, no OAuth.

Add a new article

1. Create src/content/articles/<slug>.mdx with the frontmatter described in src/content.config.ts.
2. Set volume, issue, and mint a DOI on Zenodo.
3. Open a PR.

Propose a skill

Open the plugin repo: https://github.com/stencil-pub/stencil. Click "Propose a skill" on stencil.pub/plugin/ or create a new file at skills/<slug>.md directly.

License

Site code: MIT. Article content: CC-BY-4.0 unless otherwise noted.