when-words

Translate validated TypeScript leaf-node implementations into native languages with UTC date math.

1|1|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/caryden/special --skill when-words
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: when-words
Source: https://github.com/caryden/special/tree/main/skills/when-words
Command: npx skills add https://github.com/caryden/special --skill when-words

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI coding agents need a streamlined, language-agnostic recipe to port a verified multi-node skill into native code without external dependencies, preserving behavior and test vectors.

Core Features & Use Cases

  • Leaf-node library: five independent functions (time-ago, duration, parse-duration, human-date, date-range) with a shared spec.
  • Language-agnostic translation: guided by node specs, test vectors, and a verified TypeScript reference implementation.
  • End-to-end provenance: generates native code that is pure, self-contained, and verifiable against the same tests.

Quick Start

Describe how to port the five leaf nodes from the TypeScript reference into a target language and validate against the reference tests.

Frequently Asked Questions about when-words

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I translate TypeScript date formatting functions into native code without dependencies?

Translating TypeScript date formatting functions into native code requires porting validated reference implementations for five leaf nodes. This Skill generates pure, zero-dependency native functions guided by node specs, test vectors, and UTC-based date math to preserve original behavior.

What is the best way to port a TypeScript time-ago utility to another programming language?

Porting a TypeScript time-ago utility involves translating the verified reference implementation using per-node specs and test vectors. This approach yields pure native functions with deterministic results, explicit inputs, and provenance annotations tracing back to the original source skill.

Can I generate human-date and date-range functions in a target language with zero external dependencies?

You can generate human-date and date-range functions with zero external dependencies. The Skill translates five independent leaf nodes from a TypeScript reference into pure, self-contained native code that remains verifiable against the original test vectors.

Does porting a TypeScript duration parser require preserving test vectors in the native output?

Porting a TypeScript duration parser requires preserving test vectors to guarantee deterministic results. The translation process is guided by per-node specs and examples, producing verifiable native code that matches the original reference behavior exactly.

Why do my translated date-range functions produce different results than the TypeScript reference?

Translated date-range functions produce different results when native code fails to strictly follow UTC-based date math. The Skill enforces pure functions with explicit inputs and provenance annotations to prevent behavioral deviations from the verified TypeScript reference implementation.