digirati-co-uk/extensions-media
.agents/skills/extensions-media/SKILL.md
Work on Madoc TS media extension upload, metadata, and API flows. Use when changing media ingestion rules, thumbnail generation, or media API calls in services/madoc-ts.
$ install --global
skillsauthnpx skillsauth add digirati-co-uk/madoc-platform extensions-mediaInstall 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 PM5.3s2 files scanned
SKILL.md
- name:
- extensions-media
- description:
- Work on Madoc TS media extension upload, metadata, and API flows. Use when changing media ingestion rules, thumbnail generation, or media API calls in services/madoc-ts.
Media Extensions (Madoc TS)
Goal
Document media extension behavior so media upload, metadata creation, and thumbnail generation remain consistent.
Scope
- Media extension upload workflow
- Media record creation and API calls
- Thumbnail generation and storage API calls
Non-scope
- Media route handlers or storage backend implementation
- Frontend UI for media selection
- Non-media extensions
Key Entry Points
services/madoc-ts/src/extensions/media/extension.tsservices/madoc-ts/src/types/mediaservices/madoc-ts/src/routes/media/services/madoc-ts/src/routes/assets/
Architecture Summary (Based on Source)
MediaExtension.createMediavalidates file type/size, reads image dimensions, creates a media record, uploads to storage, then generates thumbnails.- Media APIs live under
/api/madoc/mediaand storage uploads use/api/storage/data/media/public/{id}/{fileName}. - Thumbnail generation is triggered via
/api/madoc/media/{id}/generate-thumbnails.
Quick Start Workflow
- Review
services/madoc-ts/src/extensions/media/extension.tsto understand validation and upload flow. - Confirm expected media types and metadata in
services/madoc-ts/src/types/media. - Check relevant media routes if you need to align API changes.
Common Tasks
- Adjust accepted media file types or size limits
- Update media metadata fields on creation
- Change thumbnail sizes or generation flow
Pitfalls
- Breaking upload path or storage bucket assumptions
- Skipping thumbnail generation after upload
- Inconsistent metadata with backend expectations
Suggested Checks
- Upload a PNG/JPEG and verify stored media
- Generate thumbnails for an uploaded media item
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