CtrlK
BlogDocsLog inGet started
Tessl Logo

quote

为 shiji-kb wiki 页面补全「史记引文」节。搜索实体标注文件中对该页面实体的真实引用(而非裸字符匹配),展开已知 PN 的完整段落,过滤已引,输出新增候选。当用户说 /quote PAGE 时触发。

73

Quality

92%

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

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

Concise, actionable, and well-structured with a real bundle script. The main weakness is workflow clarity: a batch page-mutation workflow without an explicit validation/verification checkpoint or error-recovery loop, which the rubric caps at 3.

Suggestions

Add an explicit validation checkpoint after generating candidates and before writing, e.g. 'verify each candidate paragraph is a real entity reference (not a bare string match) before appending'.

Include a feedback loop for the write step: 'after appending, re-read the 史记引文 section to confirm format and ordering are correct; fix and re-check if not'.

Make the append-only/dedup guard an explicit checkpoint in step 3 (e.g. 'confirm no duplicate PN before writing') rather than only a stated rule.

DimensionReasoningScore

Conciseness

Lean body using tables and concrete commands with no padding; the 注意事项 section covers genuinely non-obvious domain specifics (r-type PN rows, 同名异义) that earn their tokens.

5 / 5

Actionability

Provides copy-paste ready commands (python3 .claude/skills/quote/scripts/quote_page.py PAGE --max 30), concrete regex patterns per entity type, exact citation format, and the mandatory record_revision.py invocation.

5 / 5

Workflow Clarity

Five steps are clearly sequenced, but this batch write operation (appending citations to wiki pages) lacks an explicit validation checkpoint or validate→fix→retry feedback loop, so the batch-operation cap applies.

3 / 5

Progressive Disclosure

Well-organized into 用法/执行步骤/实体类型/注意事项 sections with implementation delegated to the referenced scripts/quote_page.py bundle file (verified to exist), one level deep and clearly signaled.

5 / 5

Total

18

/

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 tight, specific description that covers what and when concretely with a distinct trigger. The only gap is thin trigger-term coverage — a single slash-command form with no natural-language synonyms.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 搜索实体标注文件中的真实引用、展开已知PN完整段落、过滤已引、输出新增候选 — giving comprehensive coverage of what the skill does.

5 / 5

Completeness

Clearly states both what (search real references, expand paragraphs, filter, output candidates) and when ('当用户说 /quote PAGE 时触发') with a concrete trigger phrase.

5 / 5

Trigger Term Quality

The explicit trigger phrase '当用户说 /quote PAGE 时触发' is a natural, concrete term users would say, but coverage is limited to a single slash-command form with no synonyms or variants.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (shiji-kb wiki 史记引文补全) with a distinct /quote PAGE trigger, making conflict 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.

Validation — 16 / 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.