yellow-bell-calculation-method

Use when establishing the fundamental pitch standard (黄钟) or deriving all twelve pitch pipes. Calculates the 9-cun base unit from powers of 3 and links musical tuning to weights, measures, and seasonal timing.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./kg/ontology/ontology-v1/skus/procedural/skill_054/SKILL.md

Quality

Content

57%

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-organized and appropriately concise for a single-file calculation skill, with a useful validation section. Its main weaknesses are an incomplete pitch enumeration ("Continue through all twelve pitches") and mild redundancy between the intro and Overview lines.

Suggestions

Replace "Continue through all twelve pitches" with the full list of remaining pitch ratios so the derivation is complete and copy-paste ready.

Merge or trim the Overview line, which duplicates the opening sentence about deriving all pitches from Yellow Bell.

Consider whether the classical-Chinese "Key Principles" aphorisms earn their tokens; if retained, tie each explicitly to a calculation step rather than presenting them as standalone philosophy.

Dimension	Reasoning	Score
Conciseness	Mostly efficient, but the Overview line ("Yellow Bell serves as the fundamental pitch from which all other pitches are derived through mathematical calculation") restates the opening sentence, and the classical-Chinese "Key Principles" aphorisms add ornamental context that does not advance the calculation.	2 / 3
Actionability	Gives concrete elements (the 3^9 = 19683 divisor, 9-寸 result, and the first four pitch fractions), but the derivation is incomplete — it lists only 丑/寅/卯/辰 then says "Continue through all twelve pitches" without the remaining ratios, leaving a key detail missing.	2 / 3
Workflow Clarity	Steps are sequenced (establish base → calculate successive pitches → validate) and a Validation section exists, but the pitch-derivation sequence has a gap and validation is a terminal checklist rather than embedded checkpoints with feedback loops.	2 / 3
Progressive Disclosure	A single-file skill under 50 lines with no external references needed; content is organized into clear sections (Overview, Base Calculation, Mathematical Formula, Key Principles, Application, Validation), satisfying the simple-skill anchor for well-organized structure.	3 / 3
	Total	9 / 12 Passed

Description

100%

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 strong, third-person description with concrete capabilities, an explicit "Use when" trigger, good domain keyword coverage, and a distinctive niche. It clearly answers both what the skill does and when to invoke it.

Dimension	Reasoning	Score
Specificity	Names multiple concrete actions — "establishing the fundamental pitch standard", "deriving all twelve pitch pipes", "Calculates the 9-cun base unit from powers of 3", "links musical tuning to weights, measures, and seasonal timing" — rather than vague language.	3 / 3
Completeness	Explicitly answers both what (calculates the 9-cun base unit, derives pitches, links to weights/measures/timing) and when via an explicit "Use when establishing... or deriving..." trigger clause.	3 / 3
Trigger Term Quality	Covers the natural domain terms a user of this niche would say — "黄钟", "pitch standard", "twelve pitch pipes", "musical tuning", "weights, measures", "seasonal timing" — matching the anchor for good coverage of natural terms.	3 / 3
Distinctiveness Conflict Risk	Occupies a clear, narrow niche (Yellow Bell / 黄钟 pitch calculation) with distinct triggers, making conflict with other skills unlikely.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

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.

Repository: baojie/shiji-kb
Path: kg/ontology/ontology-v1/skus/procedural/skill_054/SKILL.md
Commit: 79c272f

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.