CtrlK
BlogDocsLog inGet started
Tessl Logo

ljg-explain

把概念、公式、机制与原理讲到能辨认、能推导、能迁移:用通俗中文接通具体情境、判别依据、运作过程和成立条件。USE WHEN 用户调用 ljg-explain、说「通俗易懂地讲解」「讲透这个概念或公式」「费曼讲解」「ELI5」,或希望从零理解一个知识点并能用于新情境。NOT FOR 单纯润色或翻译、整篇伴读、整本书或论文解读、只要求形式证明或操作步骤。

67

Quality

84%

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

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-crafted, self-contained instruction skill: concrete pedagogical standards, explicit completion criteria, pre-delivery checks, and well-organized sections with no unnecessary bundle files. Its weaknesses are minor — slight repetition of the condition-change guidance, no sample of the actual delivered output, and an implicit rather than explicit step ordering.

Suggestions

Add one compact sample deliverable (a short excerpt of a finished explanation plus one self-test question and answer) to make the output format concrete rather than only described.

Trim the recurring condition-change guidance — 理解标准 #4, the last bullet of 公式与原理, and the Gotchas entry cover overlapping ground — into one authoritative statement plus cross-cutting examples.

State the working order once (assess reader → explain → verify via self-test → deliver) in 读者与交付 so the implicit pipeline is explicit without contradicting the content-driven organization.

DimensionReasoningScore

Conciseness

The body is dense and directive with essentially no padding and no explanations of concepts Claude already knows — every bullet issues guidance like "第一句落在核心判断或读者真正关心的疑惑上" and "推导只展开承重步骤". It sits at 'efficient; minor instances of over-explanation that could be trimmed': the condition-change idea recurs across 理解标准 #4 ("在原情境里改变一个关键条件"), 公式与原理 ("同一情境改变一个变量"), and Gotchas, and a few clauses in 中文表达 elaborate past the point a competent model needs, so it is not the fully lean 5.

4 / 5

Actionability

For an instruction-only skill, the guidance is concrete and executable: it specifies deliverable format ("自测题与参考答案分开放,答案放在末尾"), concrete techniques ("用简单数值跑通一次", "先把意思落到具体情境,再给名称"), a pre-delivery check ("按「会这样跟一个聪明朋友说话吗」检验口语"), and three worked example briefs in Examples. It falls short of 'fully executable / copy-paste ready' only because there is no sample of the actual output shape (e.g., a short model explanation or self-test question with its answer), leaving minor gaps; it is well above the pseudocode-level 3.

4 / 5

Workflow Clarity

The skill defines explicit completion criteria (理解标准 1-5: 知道为什么需要它 / 能辨认 / 能解释结果 / 能随条件改判断 / 能迁移) plus pre-delivery checkpoints ("交付前按「会这样跟一个聪明朋友说话吗」检验口语" and "必要时用可用计算工具复算,检查单位、比例、正负号和舍入"). No destructive or batch operations exist, so no validation cap applies. It matches 'clear sequence with most checkpoints present; minor validation gaps' — the step order (assess reader → explain → self-test → deliver) is implicit in the topic sections rather than laid out as a numbered pipeline, which the skill justifies ("组织方式由内容决定") but still leaves the sequence slightly less explicit than the 5.

4 / 5

Progressive Disclosure

The skill is a self-contained, well-organized single file with seven clear section headers (读者与交付, 理解标准, 公式与原理, 中文表达, 证据与版式, Gotchas, Examples), no bundle files, and no content that warrants external references — the ~62-line body is entirely overview-level guidance. Per the simple-skill guidance, well-organized sections with no need for external references score at the top; navigation is trivial and nothing is buried or inlined that belongs elsewhere.

5 / 5

Total

17

/

20

Passed

Description

83%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 concrete capabilities in third person, pairs them with an explicit USE WHEN clause of natural trigger phrases, and adds a NOT FOR boundary that reduces conflict risk. Its only weaknesses are minor — a few common trigger variations are missing, and the capability list could be marginally more concrete.

Suggestions

Add one or two everyday trigger variations such as 「用大白话解释一下」「X 到底是什么意思」 to broaden natural-term coverage.

Consider naming the concrete deliverable (e.g., 讲解正文加自测题) in the what-clause to make the capability description even more concrete.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — "讲到能辨认、能推导、能迁移" and "接通具体情境、判别依据、运作过程和成立条件" — over the named domain of "概念、公式、机制与原理". This matches the 'lists several specific actions; minor gaps in coverage' anchor; it is not a 5 because the actions are capability outcomes (recognize, derive, transfer) rather than a fully comprehensive list of concrete operations, and it is clearly above the 1-2-action level of a 3.

4 / 5

Completeness

It explicitly answers both what ("把概念、公式、机制与原理讲到能辨认、能推导、能迁移:用通俗中文接通具体情境、判别依据、运作过程和成立条件") and when (a literal "USE WHEN" clause with concrete trigger phrases, further sharpened by a "NOT FOR" exclusion list). This directly matches the top anchor: clear what AND when with concrete trigger phrases, in descriptive voice with no first/second person.

5 / 5

Trigger Term Quality

Natural user phrasings are well covered: 「通俗易懂地讲解」「讲透这个概念或公式」「费曼讲解」「ELI5」, plus the explicit skill-name invocation (用户调用 ljg-explain) and "希望从零理解一个知识点并能用于新情境". It fits 'good keyword coverage; a few natural terms missing' — common variations like 「解释一下 X」「大白话讲讲」「这是什么意思」 are absent, so it falls just short of the comprehensive-synonym anchor at 5.

4 / 5

Distinctiveness Conflict Risk

The niche is fairly clear — plain-language conceptual explanation in Chinese, with quoted trigger phrases — and the "NOT FOR 单纯润色或翻译、整篇伴读、整本书或论文解读、只要求形式证明或操作步骤" clause actively fences off adjacent skills. It matches 'mostly distinct; minor overlap risk with closely related skills' because general explanation/Q&A skills could still overlap on ordinary 「解释一下」 requests that aren't among the listed triggers; the explicit skill-name trigger keeps conflict low but not minimal.

4 / 5

Total

17

/

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.

Repository
lijigang/ljg-skills
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.