CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

minimal-implementation

以最小正确改动完成代码、Skill、规则、脚本、修复、重构和工作流修改,并提供可复核的验证证据。用于修改代码、Skill、规则文件、脚本、辅助函数或工具,或用户要求优化、改进、重构、稳定化和增强鲁棒性的场景,避免不必要的辅助代码、降级路径、抽象、依赖、整文件重写和无关重构。

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

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

An exemplary compact, disciplined SKILL.md body: lean prose, a concrete decision ladder, explicit pre-edit budgeting, and a strong verification stance that rejects stale evidence. The only meaningful gap is the absence of a small worked example and an explicit verify-and-retry loop, which keep actionability and workflow clarity at 4 rather than 5.

DimensionReasoningScore

Conciseness

The ~49-line body is lean: every section (核心规则, 决策阶梯, 变更预算, 安全边界, 输出契约, 验证) adds guidance Claude does not already have, with zero padding and no explanation of basic concepts. It neither dips into anchor 4's 'minor over-explanation' territory nor needs tightening anywhere.

5 / 5

Actionability

For an instruction-only skill the guidance is largely executable: the 决策阶梯 is a concrete 7-step ordered checklist ("项目中是否已有实现…" → "标准库是否足够?" → "已安装依赖是否足够?"), and 验证 names concrete evidence types ("新鲜的定向测试、validator、哈希、渲染结果或直接行为检查"). It falls short of 5 because no worked example is given — e.g. a sample 'before/after' diff or a concrete 变更预算 entry — which would make the abstract rules copy-paste applicable; it is well above 3 since the steps are specific and ordered, not pseudocode.

4 / 5

Workflow Clarity

The sequence is clear: apply the 决策阶梯, "在第一个满足请求的层级停止", write the 变更预算 before editing, then verify with "新鲜的定向测试、validator、哈希" — so the destructive/batch-operation validation cap does not apply (validation evidence is explicitly required and stale evidence rejected: "不要把 exit code 或旧产物单独当作成功证据"). It misses 5 only because the error-recovery loop (verify → fix → re-verify) is implied rather than an explicit step.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references — no references/, scripts/, or assets/ directories exist and the body cites none — and the guideline explicitly allows a 5 for such skills with well-organized sections. The six section headers are clear, non-nested, and each is scannable, so nothing is buried or inlined that belongs in a separate file.

5 / 5

Total

18

/

20

Passed

Description

80%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 well-constructed description that explicitly answers both what the skill does and when to use it, with strong natural trigger terms and an unusually good negative-scope clause. Its main weakness is breadth: the triggers cover nearly all code-modification requests, so it risks firing in place of more specialized skills.

DimensionReasoningScore

Specificity

The description names several concrete actions and objects — "以最小正确改动完成代码、Skill、规则、脚本、修复、重构和工作流修改,并提供可复核的验证证据" plus an explicit avoidance list ("避免不必要的辅助代码、降级路径、抽象、依赖、整文件重写和无关重构"). It is not a 5 because the actions are stated at a policy level without enumerating the concrete deliverables (e.g. what form the '可复核的验证证据' takes), and it is well above a 3 since both the action set and scope boundaries are explicit.

4 / 5

Completeness

Both halves are explicit: 'what' — "以最小正确改动完成代码、Skill、规则、脚本、修复、重构和工作流修改,并提供可复核的验证证据"; 'when' — "用于修改代码、Skill、规则文件、脚本、辅助函数或工具,或用户要求优化、改进、重构、稳定化和增强鲁棒性的场景", an explicit trigger clause with concrete phrases. The 'when' is not merely implied (so 4 is too low) and nothing is vague (so 3's cap does not apply).

5 / 5

Trigger Term Quality

Good natural keyword coverage: "修改代码", "优化", "改进", "重构", "稳定化", "增强鲁棒性", "脚本", "Skill", "规则文件", "辅助函数", "工具" — terms users would actually say when requesting this behavior. Not a 5 because common variations are missing (e.g. "修复 bug", "修好", "简化", or English equivalents like 'refactor'/'fix'), leaving a few natural phrases uncovered; clearly above a 3 since multiple relevant trigger phrases are present.

4 / 5

Distinctiveness Conflict Risk

The minimal-change niche is recognizable, but the trigger surface ("修改代码…优化、改进、重构") spans virtually any code-change request, creating real overlap risk with other engineering-discipline skills (code review, simplify, verify). It is more anchored than anchor 2's generic 'helps with document files' because the minimal-change scope and avoidance rules differentiate it, but the breadth of triggers keeps it from 4.

3 / 5

Total

16

/

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

ooooooooooooooooooop/agent-tools

Path

skills/minimal-implementation/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.