CtrlK
BlogDocsLog inGet started
Tessl Logo

calendar-calculation-method

Use when calculating calendars, determining seasonal timing, or establishing the correct 正朔. Covers leap month intercalation using the 19-year Metonic cycle, solstice measurement via shadow length (晷景), and dynastic calendar differences.

64

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./kg/ontology/ontology-v1/skus/procedural/skill_061/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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.

The body is well-structured with a clear sequenced workflow and validation section, but it is held back by abstract computational guidance and minor padding. Adding the actual intercalation arithmetic and trimming non-executable sections would materially improve it.

Suggestions

Replace abstract leap-month guidance ('Track discrepancy... Insert leap month when discrepancy reaches one month') with the concrete arithmetic — e.g., accumulate 29.53-day lunar months vs. 365.25-day solar years and insert the leap month at the specific remainder threshold.

Remove or repurpose the 'Expected Outcomes' section, which states goals rather than instructions and adds no executable value.

Explain the 'Recording Format' fields (岁名, 月名, 日得, 大馀/小馀) with one-line definitions or a worked example, so the terms are actionable rather than listed bare.

DimensionReasoningScore

Conciseness

Mostly efficient bullet-style content, but sections like 'Expected Outcomes' ('Accurate seasonal predictions', 'Proper timing for agricultural activities') and unexplained 'Recording Format' fields (岁名, 月名, 日得) add padding without aiding execution.

3 / 5

Actionability

Concrete data points exist (19 years = 235 lunar months, 7 leap months, dynastic month mappings), but the core computational method is abstract — 'Track discrepancy' and 'Insert leap month when discrepancy reaches one month' lack the actual arithmetic to execute.

3 / 5

Workflow Clarity

Steps 1–4 are clearly sequenced and a dedicated 'Validation' section provides three explicit checkpoints, though the validation is not embedded as a tight fix→retry loop within the step sequence.

4 / 5

Progressive Disclosure

No bundle files exist and all content is single-file with clear, well-organized section headers; structure is good for a self-contained skill, though no detailed material is split out for deeper reference.

4 / 5

Total

14

/

20

Passed

Description

92%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.

The description is strong: it explicitly answers both what the skill does and when to use it, with concrete, domain-specific actions and low conflict risk. The only minor gap is trigger-term breadth, where a few natural synonyms could be added.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'calculating calendars', 'determining seasonal timing', 'leap month intercalation using the 19-year Metonic cycle', 'solstice measurement via shadow length (晷景)', and 'dynastic calendar differences' — giving comprehensive coverage of the skill's capabilities.

5 / 5

Completeness

Both 'what' (covers intercalation, solstice measurement, dynastic differences) and 'when' ('Use when calculating calendars, determining seasonal timing, or establishing the correct 正朔') are explicitly stated with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural phrases like 'calculating calendars', 'seasonal timing', and 'leap month' are present, but coverage lacks common synonyms and file-extension-style variants; it is good but not exhaustive for this niche.

4 / 5

Distinctiveness Conflict Risk

The historical Chinese calendar-calculation niche is highly specific with distinct triggers (正朔, Metonic cycle, 晷景), making overlap with other skills minimal.

5 / 5

Total

19

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
baojie/shiji-kb
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.