digirati-co-uk/ssr-site
.agents/skills/ssr-site/SKILL.md
Work on Madoc TS site SSR pipeline, HTML template injection, and site render data wiring. Use when changing site SSR behavior, template tokens, or site SSR data wiring in services/madoc-ts.
$ install --global
skillsauthnpx skillsauth add digirati-co-uk/madoc-platform ssr-siteInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 3:52 PM12.7s2 files scanned
SKILL.md
- name:
- ssr-site
- description:
- Work on Madoc TS site SSR pipeline, HTML template injection, and site render data wiring. Use when changing site SSR behavior, template tokens, or site SSR data wiring in services/madoc-ts.
Site SSR (Madoc TS)
Goal
Document the site SSR flow so template injection and SSR render data stay consistent.
Scope
- Site SSR route handler
- Site template token injection
- Site SSR data wiring (theme, slots, locales)
Non-scope
- Admin SSR flow
- Frontend component implementation
- Non-SSR site routes
Key Entry Points
services/madoc-ts/src/routes/frontend/site-frontend.tsservices/madoc-ts/src/frontend/site/server.tsservices/madoc-ts/src/site.html
Architecture Summary (Based on Source)
site-frontend.tsbuilds SSR inputs (theme, slots, locales, user) and renders viafrontend/site/server.- SSR injection uses
<!--ssr-outlet-->and<!--ssr-head-->tokens insite.html. - Development SSR injects Vite dev scripts and a site stylesheet; production uses template replacement.
Quick Start Workflow
- Review
services/madoc-ts/src/routes/frontend/site-frontend.tsfor SSR input wiring and theme resolution. - Inspect
services/madoc-ts/src/frontend/site/server.tsfor render options and output shape. - Confirm
services/madoc-ts/src/site.htmltoken locations for SSR injection.
Common Tasks
- Add new data passed into site SSR render
- Update site HTML template tokens
- Adjust theme or slot resolution logic
Pitfalls
- Mismatched template tokens causing blank SSR output
- Incorrect theme resolution leading to stale theme cache
- Updating dev SSR scripts without matching Vite port
Suggested Checks
- Site SSR request in production mode
- Site SSR request with theme override and slots
Related Skills
digirati-co-uk/utility-core
tools
VerifiedTrustedCommunity
Work on Madoc TS shared utility helpers (JWT, metadata, errors, IIIF helpers, auth helpers). Use when changing core utility functions or shared helpers in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026
digirati-co-uk/types-schemas
development
VerifiedTrustedCommunity
Work on Madoc TS shared type definitions and schema contracts. Use when updating TypeScript types, JSON schema shapes, or cross-layer data contracts in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026
digirati-co-uk/tasks-automation
tools
VerifiedTrustedCommunity
Understand and extend Madoc TS task automation, including bots and task-related extensions. Use when adding task automation, bot behavior, or task metadata resolution in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026
digirati-co-uk/ssr-pipeline
development
VerifiedTrustedCommunity
Trace or modify Madoc TS server-side rendering for site and admin. Use when changing SSR output, template injection, dev HMR SSR wiring, or debugging SSR redirects and template tokens in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026