digirati-co-uk/frontend-core
.agents/skills/frontend-core/SKILL.md
Work on Madoc TS frontend structure for site and admin. Use when changing React routes, SSR render entrypoints, shared utilities, or component organization in services/madoc-ts.
$ install --global
skillsauthnpx skillsauth add digirati-co-uk/madoc-platform frontend-coreInstall 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 PM7.1s2 files scanned
SKILL.md
- name:
- frontend-core
- description:
- Work on Madoc TS frontend structure for site and admin. Use when changing React routes, SSR render entrypoints, shared utilities, or component organization in services/madoc-ts.
Frontend Core (Madoc TS)
Overview
Describe the site/admin frontend layout, route construction, SSR entrypoints, and shared utilities used across the UI.
Key Entry Points
- Frontend root:
services/madoc-ts/src/frontend/ - Site app:
services/madoc-ts/src/frontend/site/ - Admin app:
services/madoc-ts/src/frontend/admin/ - Shared UI/utilities:
services/madoc-ts/src/frontend/shared/ - Theme definitions:
services/madoc-ts/src/frontend/themes/ - Site SSR entry:
services/madoc-ts/src/frontend/site/server.ts - Admin SSR entry:
services/madoc-ts/src/frontend/admin/server.tsx - Site routes:
services/madoc-ts/src/frontend/site/routes.tsx - Admin routes:
services/madoc-ts/src/frontend/admin/routes.tsx
Architecture Summary (Based on Source)
- Site and admin are separate React apps with their own
clientandserverentrypoints. - SSR is created via
createServerRendererinsrc/frontend/shared/utility/create-server-renderer.tsx. - Route definitions are React Router
RouteObjectstructures (site uses acreateRoutesfactory). - Site uses nested route structures for collections/manifests/canvas/page routing.
- Admin uses route definitions in
admin/routes.tsxand SSR inadmin/server.tsx.
Styling Policy
- Tailwind is preferred for new and updated UI.
- Styled-components are being phased out.
- If you must modify a styled-components component, consider creating a 100% API-compatible alternative using Tailwind.
- Keep visual behavior extremely similar (spacing can map to nearest Tailwind sizes).
Quick Start Workflow
- Identify whether your change is site or admin and start in the correct subfolder.
- For routing changes:
- Site: update
site/routes.tsxand corresponding loader or page components. - Admin: update
admin/routes.tsxand related components.
- Site: update
- For SSR changes, inspect
site/server.tsoradmin/server.tsxandcreate-server-renderer.tsx. - For shared behavior, check
frontend/shared/utilities before duplicating logic.
Common Tasks
- Add a new page or route
- Update a loader or route data fetch
- Adjust shared UI utility
- Modify SSR behavior or data prefetching
Pitfalls
- Updating a route without updating its loader or data fetch logic
- Mixing site/admin components or routes
- Forgetting to update both server and client entrypoints when changing SSR behavior
Suggested Checks
- Run a local SSR request for a site page
- Run a local SSR request for an admin page
- Verify the route renders in the client after hydration
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-site
development
VerifiedTrustedCommunity
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.
56SKILL.mdUpdated Apr 16, 2026