CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

evolution-proposal

把 evolution-inbox 中的审计异常条目转化为可评审的进化提案(规则/技能/插件/路由补丁)。先做系统化问题分析(量化基线→全量聚合→根因分类→优先级排序),再用便宜模型起草、前沿模型评审、人工批准后走既有门禁固化。用于处理 evolution_scan.js 产出的异常条目、复盘高频反模式、把会话经验固化为规则或技能改进。不用于单轮小修改和 L0 治理规则的直接修改(只产提案不越权固化)。

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

70%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 operationally strong skill body with an exemplary five-phase workflow, real commands, paths, and validation loops. Its weaknesses are repetition of the proposal contract across three places and a monolithic single-file structure with no progressive-disclosure split for a skill of this complexity.

Suggestions

Eliminate the duplicated proposal contract: keep the full markdown template in 阶段 4 and reduce 输出契约 to '提案文档必须包含 阶段 4 模板中的全部字段' instead of re-listing the fields twice more.

Split the detailed procedure out of SKILL.md: move the nine-step analysis recipe (步骤 1.1–1.6) and the tool mapping into a references/ file (e.g., references/analysis-procedure.md) with one clearly signaled link, keeping SKILL.md as the phase-level overview.

Tighten the mnemonic asides in 阶段 1 (e.g., the '没有数字…是感觉' / '闭门造车' interjections) since the numbered steps already enforce these rules, and state the borrow-search probe as an exact queue_cli_request example so step 1.5 is copy-paste executable.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive with little concept-explanation padding, but it is noticeably redundant: the proposal field list appears as a full template in 阶段 4 and then twice more as near-duplicate bullets in 输出契约, and the mnemonic asides ('没有数字的"问题"是感觉', '不借鉴…是闭门造车') repeat ideas already enforced by the numbered steps. Not 2 because the bulk is operational content, not explanation of things Claude already knows.

3 / 5

Actionability

Concrete, executable guidance throughout: 'Get-Content ~/.agent-broker/topics/skills/evolution-inbox/workspace/inbox.jsonl', 'queue_cli_request + 单次 request_result(wait=60~120)', 'dsh-retry-analysis.js', 'quality_report.py --strict', 'dsh-config-sync --check', plus an exact output path pattern and a copy-paste proposal template. Not 5 because several steps remain directive rather than executable (e.g., '估算改动引入的额外 token 成本' and the borrow-search probes give no exact query commands).

4 / 5

Workflow Clarity

Five clearly sequenced phases with numbered sub-steps, explicit validation checkpoints (static pre-checks in 阶段 3, PASS/REJECT review, read-only --check/--strict verification commands), a feedback loop via the inbox status flow 'new → processing → applied | rejected', and a five-point self-acceptance checklist in 验证. This matches the top anchor for explicit validation steps and error-recovery loops.

5 / 5

Progressive Disclosure

The SKILL.md is well-sectioned with headers and one flat level of navigation, but it is a ~130-line monolith: the nine-step analysis procedure, the tool-mapping table, and the proposal template are all inlined with no bundle files (no references/, scripts/, or assets/ exist) and no split of operational detail into one-level-deep reference files. Not 4 because content that would benefit from being separate (e.g., the detailed analysis steps or proposal template) is fully inline.

3 / 5

Total

15

/

20

Passed

Description

88%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, information-dense description that explicitly answers what, when, and when-not with concrete pipeline actions and specific system artifacts. Its only weaknesses are reliance on ecosystem-internal jargon as trigger terms and partial overlap with the systematic-optimization skill it builds on.

DimensionReasoningScore

Specificity

The description enumerates concrete, end-to-end actions: converts audit anomaly entries into reviewable proposals (rules/skills/plugins/route patches), runs systematic problem analysis (quantified baseline → full aggregation → root-cause classification → prioritization), then cheap-model drafting, frontier-model review, and human approval through existing gates. Not the level below (4) because coverage of the pipeline is comprehensive rather than having minor gaps.

5 / 5

Completeness

Both 'what' (transform audit anomalies into reviewable evolution proposals via a defined analyze → draft → review → approve pipeline) and 'when' are explicitly answered: '用于处理…异常条目、复盘高频反模式、把会话经验固化为规则或技能改进', plus an explicit negative trigger ('不用于单轮小修改和 L0 治理规则的直接修改'). This matches the anchor for clear and explicit what AND when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural trigger phrases users of this system would say are present — '处理 evolution_scan.js 产出的异常条目', '复盘高频反模式', '把会话经验固化为规则或技能改进'. Not 5 because much of the vocabulary is internal jargon (进化提案, 前沿模型评审, L0 治理) that limits natural synonym coverage; not 3 because the phrases that are there are the ones a user would actually say when needing this skill.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche anchored to specific artifacts (evolution-inbox, evolution_scan.js) and explicitly disambiguates from minimal-implementation and L0 governance edits via the 不用于 clause. Not 5 because the analysis/root-cause phases substantially overlap with systematic-optimization, leaving minor risk of triggering for the wrong skill.

4 / 5

Total

18

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

ooooooooooooooooooop/agent-tools

Path

skills/evolution-proposal/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.