utility-core

What problem does it solve?

Changes to shared utility helpers can introduce subtle bugs, cross-service incompatibilities, and runtime failures; this Skill helps document, validate, and guide safe updates to Madoc's common TypeScript utilities to reduce regressions and ensure consistent behavior.

Core Features & Use Cases

• JWT helpers: review, parse, verify, and sign token helpers to ensure correct validation and compatibility across services.
• IIIF and metadata mapping: standardize IIIF helpers and metadata transformations for consistent indexing and display logic.
• Error and Slonik utilities: maintain error classes, request helpers, and Slonik helpers to keep deterministic behavior and reliable database interactions.
• Use Case: when updating parse-jwt or verify-signed-token, the Skill guides changes, recommends tests, and checks for browser/server compatibility.

Quick Start

Use the utility-core skill to review services/madoc-ts/src/utility/parse-jwt.ts and propose a safe, deterministic refactor with test coverage and cross-environment compatibility.