CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/dst-transition-reference

Use when designing or auditing time-handling code or its tests around daylight saving time: skipped and repeated hours, jurisdiction differences, the IANA tz database, cron jobs that fire zero or two times, billing and meetings on transition days, plus leap seconds and clock smearing.

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, information-dense reference skill: lean tables, concrete fixture timestamps and library behaviors, a clear usage workflow, and exemplary one-level-deep bundle organization. The only notable gaps are the absence of an executable test-code example and minor re-explanation of well-known DST rules.

Suggestions

Add one copy-paste-ready test snippet (e.g. a Python zoneinfo assertion for the 2026-03-08 02:30 case) in the worked example to make the guidance fully executable.

Trim the Wikipedia citation for the US spring-forward rule and the "Half the world doesn't" aside — both restate knowledge Claude already has.

DimensionReasoningScore

Conciseness

The body is dense and lean: behavior tables, terse bullets, and a stepwise worked example with no padding. Minor over-explanation of things Claude already knows (citing Wikipedia for the 2nd-Sunday-of-March US rule, "Half the world doesn't") and hardcoded 2026 fixture dates keep it below 5, though staleness is explicitly mitigated by the "refresh against IANA" instruction and Limitations section.

4 / 5

Actionability

Concrete, specific guidance throughout: exact fixture timestamps ("2026-03-08 02:30 America/New_York"), a per-library behavior table (pytz raises NonExistentTimeError, zoneinfo normalizes to 03:30 EDT), a stepwise worked example, and anti-patterns paired with fixes. Not 5 because no executable test code snippet is included — the assertions are described, not shown.

4 / 5

Workflow Clarity

"How to use this reference" gives a clear 4-step sequence (identify transition, match bug class, turn into assertion, pick zones + refresh fixtures against IANA), and the refresh step acts as a validation checkpoint. Not 5 because there are no explicit error-recovery/feedback loops; acceptable here since the skill is a reference, not a destructive or batch operation, so no cap applies.

4 / 5

Progressive Disclosure

Clear overview with well-signaled references: all three bundle files (jurisdictions-and-fixtures.md, leap-seconds.md, smear-strategies-and-history.md) are directly linked from SKILL.md one level deep, each with a stated purpose, and jurisdiction detail plus leap-second mechanics are appropriately split out. Cross-links between reference files are lateral (SKILL.md links every file directly), so there is no 2+ level nesting.

5 / 5

Total

17

/

20

Passed

Description

70%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A highly specific, well-targeted trigger description with excellent 'when' guidance and low conflict risk. Its main weakness is the missing 'what': the description never states what the skill provides, and the common abbreviation "DST" is absent from the trigger terms.

Suggestions

Add a leading capability clause stating what the skill provides, e.g. "Reference of DST transition mechanics, per-library behavior tables, and refreshable test fixtures for..." before the "Use when" clause.

Include the abbreviation "DST" and common synonyms ("time zone", "clock change", "spring forward/fall back") among the trigger terms, since users most often say "DST".

State the deliverable explicitly (e.g. "provides jurisdiction fixture timestamps and testable assertions") so the 'what' matches the detail level of the 'when'.

DimensionReasoningScore

Specificity

Names concrete actions ("designing or auditing time-handling code or its tests") and enumerates specific scenarios ("skipped and repeated hours", "cron jobs that fire zero or two times", "billing and meetings on transition days", "leap seconds and clock smearing"). Not 5 because it never states what the skill actually provides (a reference of transition mechanics, library behaviors, and test fixtures); not 3 because coverage goes well beyond 1-2 generic actions.

4 / 5

Completeness

The "when" is explicit and detailed ("Use when designing or auditing time-handling code or its tests around daylight saving time..."), but no "what" is ever stated — the description never says the skill is a reference or what it produces. Not 2 because the 'when' is far richer than the anchor example and the enumerated topics weakly imply scope; not 4 because per the guidelines capabilities must be explicitly stated, not inferred.

3 / 5

Trigger Term Quality

Good natural-keyword coverage: "daylight saving time", "time-handling code", "cron jobs", "billing", "meetings", "IANA tz database", "leap seconds" are phrases users would plausibly say. Not 5 because the extremely common abbreviation "DST" and variants like "timezone"/"time zone" or "clock change" are absent.

4 / 5

Distinctiveness Conflict Risk

Clear niche (DST transition edge cases) with distinct triggers (skipped/repeated hours, cron double-firing, transition-day billing) that would not naturally invoke a general time or testing skill; the leap-second mention is explicitly additive and signaled.

5 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

On this page