CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

complete-example

当用户明确要求"填充示例内容""生成示例""补充 LaTeX 示例"时使用。AI 增强版 LaTeX 示例智能生成器,实现 AI 与硬编码的有机融合:AI 做"语义理解"(分析章节主题、推理资源相关性、生成连贯叙述),硬编码做"结构保护"(格式验证、哈希校验、访问控制)。

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/complete-example/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is well-sectioned with a clear process, constraints, and failure-recovery handling, but it functions as an island: it never tells Claude how to actually run the skill's script pipeline, and its only file pointer (config.yaml) is missing from the bundle. Redundant policy text also dilutes token efficiency.

Suggestions

Add a '运行入口' section that points to `scripts/skill_controller.py` (and `references/README.md`) with one concrete invocation example, e.g. `python scripts/skill_controller.py --project <path> --output-mode preview`, so the existing script bundle is discoverable from SKILL.md.

Ship `config.yaml` in the bundle or inline the key default values, since the body defers all defaults and config keys (`parameters.*`, `generation.*`, etc.) to a file that is currently absent.

Deduplicate the bug-reporting rules (stated in 执行步骤 and again in 公共硬约束) and the task-directory convention (stated in both 输出管理 and 公共硬约束) to reclaim tokens and reduce drift between the two copies.

DimensionReasoningScore

Conciseness

Mostly efficient bullet-style prose with no explanations of concepts Claude already knows, but noticeably redundant: the bug-reporting rules appear twice (执行步骤 bullets and again in 公共硬约束) and the task-directory convention is stated in both 输出管理 and 公共硬约束. Not 4 because this repetition and the boilerplate constraint block could be meaningfully tightened.

3 / 5

Actionability

Provides some concrete guidance — parameter enums (`minimal`/`moderate`/`comprehensive`, `preview`/`apply`/`report`), output directory layout, and section-command whitelist rules — but no executable commands or code anywhere. The body never says how to invoke the 18-script bundle (e.g., `scripts/skill_controller.py`) and defers all defaults to a `config.yaml` that is not in the bundle, so key execution details are missing. Not 4 because there is no copy-paste-ready instruction; not 2 because inputs, outputs, and constraints are concretely specified.

3 / 5

Workflow Clarity

A clear 7-step sequence with validation checkpoints present: step 7 ("执行格式与结构验证,需要时生成质量报告"), a dedicated 校验 section, blacklist access control that must refuse illegal modifications, and a 失败与恢复 section for retry from the last failed step. Not 5 because the validation commands/checks are never named and there is no explicit validate→fix→re-validate loop; validation exists, so the destructive/batch cap of 3 does not apply.

4 / 5

Progressive Disclosure

The bundle contains 18 Python scripts and a references/README.md, yet the body references none of them — no pointer to the main controller `scripts/skill_controller.py` or to references/README.md. The only file reference, `config.yaml`, does not exist in the bundle, making it a dangling reference. This matches anchor 2 (references buried/absent, content split not navigable) rather than 3, where references would at least be present but weakly signaled.

2 / 5

Total

12

/

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 gives explicit 'use when' triggers with verbatim user phrases and a concrete what-vs-how breakdown of AI and hard-coded responsibilities. Minor buzzword framing and missing trigger synonyms keep it just below the top level.

DimensionReasoningScore

Specificity

Quotes several concrete actions: "分析章节主题、推理资源相关性、生成连贯叙述" and "格式验证、哈希校验、访问控制". It falls short of 5 because framing phrases like "AI 增强版…智能生成器" and "有机融合" are buzzwordy, and it is above 3 because more than 1-2 specific capabilities are explicitly named.

4 / 5

Completeness

Explicitly answers 'when' with a concrete trigger clause ("当用户明确要求…时使用" with quoted trigger phrases) and 'what' with a capability breakdown (semantic understanding vs. structure protection). Matches the 5 anchor: both what and when clearly stated with concrete trigger phrases.

5 / 5

Trigger Term Quality

Includes explicit natural trigger phrases users would say: "填充示例内容", "生成示例", "补充 LaTeX 示例", plus the domain keyword "LaTeX". Not 5 because common variations (e.g., .tex, 示例章节/示例表格, English phrasings) are absent; not 3 because multiple natural phrases are given verbatim.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche — generating example/placeholder content for LaTeX (NSFC/thesis) projects — with triggers unlikely to fire for unrelated skills. Not 5 because the bare phrase "生成示例" is somewhat generic and could overlap with other example-generation skills.

4 / 5

Total

17

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

huangwb8/ChineseResearchLaTeX

Path

skills/complete-example/SKILL.md

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.