implement-legal-reform

Use when implementing comprehensive legal, agricultural, or military reforms in a stagnating state. Based on Shang Yang's reforms in Qin, covers public talent recruitment, reform debate, equal law enforcement, and institutionalization of merit-based systems.

Quality

79%

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_022/SKILL.md

Quality

Content

71%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, concise procedural skill with clear sequencing and a validation section. Its main limitation is actionability: the steps describe what to do at a strategic level but lack the specific mechanisms or criteria that would make the guidance fully executable.

Suggestions

Add concrete criteria or mechanisms to each core reform step (e.g., what 'merit-based reward system' means in practice, how equal enforcement is verified) to lift actionability.

Tie the Validation section back into the steps as inline checkpoints so errors are caught during execution rather than only at the end.

Trim the redundant 'Based on Shang Yang's reforms in Qin' from the Overview since it already appears in the frontmatter description.

Dimension	Reasoning	Score
Conciseness	Lean bullet-point procedure that largely assumes the reader's competence; only minor redundancy (the Overview re-states 'Based on Shang Yang's reforms in Qin', and a few bullets restate each other) keeps it below the top anchor.	4 / 5
Actionability	Steps are concrete enough to follow but remain high-level ('Establish clear laws and punishments', 'Incentivize farming and land cultivation') without the specific mechanisms or criteria that would make the guidance fully actionable, fitting the score-3 'some concrete guidance but incomplete' anchor.	3 / 5
Workflow Clarity	A clearly sequenced 7-step process with a dedicated Validation section and Decision Points, providing most checkpoints; validation sits at the end rather than as interspersed feedback loops, so it is just below the top anchor.	4 / 5
Progressive Disclosure	A short, single-purpose skill (under 50 lines, no external references needed) with well-organized sections (Overview, Steps, Decision Points, Expected Outcomes, Validation), meeting the simple-skill exception for a top score.	5 / 5
	Total	16 / 20 Passed

Description

87%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 strong description with an explicit 'Use when...' trigger, clear multi-domain coverage, and a distinctive niche. The main weakness is that the listed capabilities are topical areas rather than crisp executable actions, which keeps specificity just below the top anchor.

Dimension	Reasoning	Score
Specificity	Names the domain and lists several concrete coverage areas ('public talent recruitment, reform debate, equal law enforcement, and institutionalization of merit-based systems'), but these are topic areas rather than sharply concrete verbs like the score-5 example, leaving minor gaps.	4 / 5
Completeness	Explicitly answers both 'what' ('covers public talent recruitment, reform debate, equal law enforcement, and institutionalization of merit-based systems') and 'when' ('Use when implementing comprehensive legal, agricultural, or military reforms in a stagnating state') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Good keyword coverage with natural phrases users would say ('legal, agricultural, or military reforms'), though common synonyms and variations across the three domains are not exhaustively covered.	4 / 5
Distinctiveness Conflict Risk	A clear, narrow niche (statecraft reform modeled on Shang Yang's Qin reforms) with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	18 / 20 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_022/SKILL.md
Commit: 6b836e3

Reviewed: 5 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.