digirati-co-uk/i18n
.agents/skills/i18n/SKILL.md
Work on Madoc TS internationalization setup for server and client. Use when changing i18next backend configuration, language detection, or locale loading in services/madoc-ts.
$ install --global
skillsauthnpx skillsauth add digirati-co-uk/madoc-platform i18nInstall 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.1s2 files scanned
SKILL.md
- name:
- i18n
- description:
- Work on Madoc TS internationalization setup for server and client. Use when changing i18next backend configuration, language detection, or locale loading in services/madoc-ts.
I18n (Madoc TS)
Goal
Document the i18n setup so locale detection and translation loading remain consistent across server and client.
Scope
- Server-side i18next setup
- Client-side i18next setup
- Locale loading paths and detection order
Non-scope
- Translation file contents
- Frontend component wording
- Non-i18n middleware
Key Entry Points
services/madoc-ts/src/middleware/i18n/i18next.server.tsservices/madoc-ts/src/middleware/i18n/i18next.client.tsservices/madoc-ts/src/utility/language-cache.tsservices/madoc-ts/src/paths.ts
Architecture Summary (Based on Source)
- Server uses
koa-i18next-detectorand aLanguageCachebackend withTRANSLATIONS_PATH. - Client uses chained backend (localStorage cache + HTTP fallback) and browser language detection.
- Locale endpoints are served under
/s/{slug}/madoc/api/locales/{lng}/{ns}.
Quick Start Workflow
- Review server config in
i18next.server.tsfor detection order and load paths. - Review client config in
i18next.client.tsfor backend chain and detection rules. - If adding namespaces, update both server and client to keep them aligned.
Common Tasks
- Add a new translation namespace
- Adjust language detection order
- Change locale loading paths
Pitfalls
- Mismatched namespaces between server and client
- Forgetting to update translation load paths after route changes
- Breaking cached language behavior by changing detector settings
Suggested Checks
- Load a page with a non-default locale cookie/querystring
- Verify client fetches locale JSON from the expected endpoint
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