sembr.org

Website for the Semantic Line Breaks specification.

Content sources

The build fetches the specification from sembr/specification's README and skill files from sembr/skills. Both sources use the main branch; set SEMBR_SKILLS_REF to build with skills from another branch. The website serves each skill through /.well-known/agent-skills/ as a .tar.gz archive with all of its files, and serves each file on its own for older clients.

Edit the specification and installation quick start in sembr/specification. The full installation and management guide belongs in sembr/skills.

Changes to the specification README trigger its deployment workflow, which builds and deploys this website. Cloudflare Workers Builds also builds and deploys this repository, and runs builds for pull requests. Changes to skill documents also need a website rebuild; after merging them, run the specification repository's Deploy workflow manually or use the deployment commands below. When adding a skill or a file to a skill, update the skill list in src/content.config.ts.

Requirements

• Node.js >=22.12.0
• npm

Setup

npm install

Development

npm run dev

Starts the local Astro dev server at http://localhost:4321.

Build

npm run build
npm run preview

npm run build writes the production site to dist/. npm run preview serves that build locally.

Deploy

npm run preview:worker
npm run deploy

npm run preview:worker builds the site and serves it locally with Wrangler. npm run deploy builds the site and deploys it to Cloudflare Workers.