digirati-co-uk/extensions-page-blocks
.agents/skills/extensions-page-blocks/SKILL.md
Work on Madoc TS page block extension definitions, editors, and rendering hooks. Use when adding page block types, updating block editors, or changing block rendering flow in services/madoc-ts.
$ install --global
skillsauthnpx skillsauth add digirati-co-uk/madoc-platform extensions-page-blocksInstall 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 PM4.6s2 files scanned
SKILL.md
- name:
- extensions-page-blocks
- description:
- Work on Madoc TS page block extension definitions, editors, and rendering hooks. Use when adding page block types, updating block editors, or changing block rendering flow in services/madoc-ts.
Page Block Extensions (Madoc TS)
Goal
Explain how page blocks are defined and rendered so new blocks or editor changes integrate with the registry and rendering pipeline.
Scope
- Page block definitions and registry
- Block editor wiring and block config helpers
- Block rendering to HTML/React and slot/page APIs
Non-scope
- General site routes or admin routes
- Unrelated extension types
- Frontend styling not tied to blocks
Key Entry Points
services/madoc-ts/src/extensions/page-blocks/extension.tsservices/madoc-ts/src/extensions/page-blocks/default-definitions.tsservices/madoc-ts/src/extensions/page-blocks/block-editor-for.tsservices/madoc-ts/src/extensions/page-blocks/simple-html-block/services/madoc-ts/src/extensions/page-blocks/simple-markdown-block/
Architecture Summary (Based on Source)
PageBlockExtensionis aRegistryExtensionusing registry nameblockand supports plugin overrides.- Definitions can be filtered by required/optional context in
getDefinitions. - Blocks can render as React or HTML; React rendering uses server-side rendering or client-side render-to-string.
- Slot/page CRUD APIs are exposed via
/api/madoc/pages,/api/madoc/slots,/api/madoc/blocks.
Quick Start Workflow
- Review
services/madoc-ts/src/extensions/page-blocks/extension.tsfor definition structure and rendering flow. - Inspect
services/madoc-ts/src/extensions/page-blocks/default-definitions.tsto see default block registrations. - Use
block-editor-for.tsor add a new definition file to register a custom block.
Common Tasks
- Add a new page block definition
- Update block editor UI or block config mapping
- Adjust block rendering output
Pitfalls
- Registering blocks with the wrong registry name (
block) - Missing required context constraints, causing blocks to appear incorrectly
- Breaking SSR rendering by returning invalid HTML
Suggested Checks
- Create a new block in the admin UI
- Render a page with the new block in SSR and client
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