CtrlK
BlogDocsLog inGet started
Tessl Logo

axiom-explainer

Write Chinese Markdown articles for university students and adults with social experience that explain one viewpoint, axiom, theorem, law, principle, or theory system through "求真讲法、求存讲法、思考", with text/Mermaid and standalone GitHub-renderable SVG files, assumptions, derivation or motivation, applicability boundaries, positive and negative examples, and save the result under the current project's markdown directory. Use when Codex is asked to generate 公理讲解文案、定理讲解、理论体系通俗解读、观点拆解、面向大学生和成年人的图文并茂 Markdown 文章.

70

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 highly actionable, well-sequenced instruction skill: exact paths, a complete article template, explicit checkpoint gates, and a failure-handling table give Claude everything needed to execute. The main weakness is token efficiency — several rules are repeated across the Workflow, checkpoints, Anti-Patterns, and Final Checks sections, and the ~240-line body could shed a reference file's worth of detail.

Suggestions

Deduplicate the rules repeated across Workflow, the quality-gate table, Visual Standards, and Final Checks (SVG relative-path/asset rules, 'don't paste the full article', assumption linkage): state each rule once at its point of use and let the checkpoints reference it.

Move the full Article Structure template and the Visual/SVG Standards detail into a references/ file (e.g., references/article-structure.md) and keep a condensed skeleton in SKILL.md to reduce inline token load.

Merge overlapping sections — Explanation Standards items 3-5 largely restate Workflow step 1 and the Failure Handling rows — into one canonical statement of the input-type-specific rules.

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows, but the same rules are restated several times: SVG relative-path and asset-directory rules appear in Workflow step 5, the quality-gate table ("Every SVG file exists under markdown/assets/<topic-slug>/... referenced with a relative path"), Visual Standards, and Final Checks; "do not paste the full article" appears in Workflow step 5 and Anti-Patterns; assumption-linkage rules appear in three places. This fits "mostly efficient but includes some unnecessary explanation or could be tightened"; not 2 because there is no conceptual padding or fluff, and not 4 because the duplication is more than a couple of minor instances.

3 / 5

Actionability

Guidance is fully concrete for an instruction-only skill: exact file paths and naming ("markdown/YYYYMMDD-<topic-slug>.md", "markdown/assets/<topic-slug>/"), a complete copy-ready article structure template, precise SVG syntax requirements ("<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"...\">", escaping &, <, >), a working Mermaid example, and a fully specified input contract.

5 / 5

Workflow Clarity

The 5-step Workflow is clearly sequenced and includes explicit validation checkpoints: two 🔴 CHECKPOINT gates with pass/fail condition tables (before drafting and before saving), a failure-handling table pairing triggers with first actions and fallbacks, and a Final Checks checklist. This provides the validate-revise-retry feedback loop the rubric's top anchor requires.

5 / 5

Progressive Disclosure

The single file has clear, well-ordered sections with no buried or nested references, so navigation is easy. Not 5 because at roughly 240 lines, content that naturally belongs in one-level-deep reference files (the full Article Structure template, the failure-handling table, Visual/SVG Standards) is fully inlined in SKILL.md, which the rubric treats as a minor organization gap rather than ideal splitting.

4 / 5

Total

17

/

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.

A strong description: it states comprehensive concrete capabilities (article types, visual formats, assumptions/boundaries, examples, save location) and closes with an explicit multi-phrase trigger clause. Only minor keyword variants are missing, and the stray reference to "Codex" where "Claude" would be expected is a small wording artifact rather than a scoring defect.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage: "Write Chinese Markdown articles... explain one viewpoint, axiom, theorem, law, principle, or theory system", "text/Mermaid and standalone GitHub-renderable SVG files, assumptions, derivation or motivation, applicability boundaries, positive and negative examples, and save the result under the current project's markdown directory". No coverage gaps; not score 4 because the action list is comprehensive rather than having minor gaps.

5 / 5

Completeness

It clearly answers both questions: the "what" is the full article-generation action list, and the "when" is the explicit "Use when Codex is asked to generate..." clause with concrete trigger phrases. Both are present and explicit.

5 / 5

Trigger Term Quality

The explicit trigger clause "Use when Codex is asked to generate 公理讲解文案、定理讲解、理论体系通俗解读、观点拆解、面向大学生和成年人的图文并茂 Markdown 文章" gives good multi-synonym keyword coverage (讲解/通俗解读/拆解 across axioms, theorems, theory systems, viewpoints). Not 5 because a few natural variants users would plausibly say (e.g., 科普文章, 原理讲解, or plain-language English phrasing) are absent.

4 / 5

Distinctiveness Conflict Risk

The 求真讲法/求存讲法/思考 framing, the Chinese teaching-article format, and the specific concept-type triggers (公理讲解文案, 定理讲解, 理论体系通俗解读, 观点拆解) form a clear niche with minimal overlap with other skills.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 missing, 3 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository
digoal/blog
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.