CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

loop-engineering

构建或修复 Agent 迭代循环时使用——解决 Agent 过早宣称完成、活干到一半就停、假成功、循环停不下来等问题,设计验证器与终止条件,实现提议者-审核者(Proposer-Reviewer)双 Agent 循环。覆盖过早终止三种形态、验证器是循环瓶颈的原则、LoopX 持久控制面、LongHorizon-Harness 的 MEA 循环、提议者-审核者最小不变量(审核者读独立证据、退回给可定位修复条件)。

Quality

81%

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

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.

The body is a well-structured, expert-level guide with an explicit validated loop pattern, concrete review schema, and strong failure-mode taxonomy. Its weaknesses are redundancy between the principles, invariants, and pitfalls sections, and external references pointing to files that are not present in the bundle.

Suggestions

Merge the overlapping '核心原则' bullets with the three minimal invariants in section 2 — '审核者必须读独立证据' and '退回必须可定位' currently appear nearly verbatim three times (principles, invariants, 常见陷阱).

Ship the referenced bundle files (chapter5/paper-to-ppt/, chapter5/video-edit/, book/chapter10.md) inside references/ or scripts/, or drop the '配套代码'/'深度阅读' sections if the paths are not part of this skill's distribution.

Move the LongHorizon-Harness benchmark figures (WeaveBench 51.8%→80.7%, token multipliers, etc.) into a one-level-deep reference file so the main body stays a lean overview of the MEA pattern.

DimensionReasoningScore

Conciseness

Mostly efficient and dense with non-obvious domain knowledge (LoopX, MEA cycle, benchmark deltas), but the '核心原则' section states '审核者必须读独立证据' and '退回必须可定位' nearly verbatim again as the three minimal invariants and again in '常见陷阱', so several bullets could be cut or merged. This is more than the 'minor instances' of the 4 anchor but well short of the heavily padded 1-2 anchors.

3 / 5

Actionability

Concrete, usable guidance throughout: a Python loop skeleton with explicit veto/repair/publish/escalate branches, per-medium evidence channels (render PNG for slides, keyframe sampling for video), a structured review schema ('page/issue_type/severity/suggestion'), and specific budget rules. The skeleton is abstract, but it is explicitly framed as a minimal pattern ('最小循环骨架'), which the rubric accepts as justified flexibility; only runnable end-to-end examples are missing.

4 / 5

Workflow Clarity

Multi-step processes are clearly sequenced with explicit validation gates: identify failure form first (section 1 table), then propose → execute/render → independent review → repair-on-veto → publish only with evidence, or escalate when budget is exhausted ('不放水通过'). The veto-repair loop is exactly the validate → fix → retry feedback loop the 5 anchor describes, and the three invariants plus termination rules act as checkpoints.

5 / 5

Progressive Disclosure

Sections are well organized and the body signals references clearly ('配套代码', '深度阅读'), but the referenced paths — 'chapter5/paper-to-ppt/', 'chapter5/video-edit/', 'book/chapter10.md' — do not exist in any references/, scripts/, or assets/ bundle, so navigation dead-ends. At ~100 lines with inlined material (e.g., the LongHorizon-Harness benchmark numbers) that could live in a reference file, this sits at the 'could be better organized' anchor rather than the good-structure 4.

3 / 5

Total

15

/

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: third-person, explicit use-when trigger up front, concrete failure-mode keywords, and clearly stated capabilities. Its only weaknesses are a topic-list tail that adds length without adding actions, and mild overlap with general agent-orchestration skills.

DimensionReasoningScore

Specificity

The description names several concrete actions — '设计验证器与终止条件' (design validators and termination conditions), '实现提议者-审核者(Proposer-Reviewer)双 Agent 循环' (implement a proposer-reviewer dual-agent loop) — plus specific failure forms ('过早宣称完成', '假成功', '循环停不下来'). It falls just short of the 5 anchor because the trailing '覆盖...' clause enumerates topic areas rather than additional concrete actions.

4 / 5

Completeness

It explicitly answers both questions: what it does ('设计验证器与终止条件,实现提议者-审核者双 Agent 循环') and when to use it, opening with the explicit trigger clause '构建或修复 Agent 迭代循环时使用' followed by concrete problem triggers. This matches the 5 anchor of clear what + when with concrete trigger phrases, and is clearly above the 4 anchor where 'when' is only loosely specified.

5 / 5

Trigger Term Quality

Natural user phrasings are well covered: 'Agent 过早宣称完成', '活干到一半就停', '假成功', '循环停不下来', '验证器', '终止条件', '提议者-审核者'. A user hitting these problems would plausibly say these words; only a few natural variants (e.g. token runaway, premature giving-up phrased in English) are absent, matching the 'a few natural terms missing' anchor.

4 / 5

Distinctiveness Conflict Risk

The niche (loop engineering, verifier design, proposer-reviewer patterns) is distinct with dedicated trigger terms like '假成功' and '提议者-审核者'. Minor overlap risk remains with broader multi-agent orchestration or workflow skills, so it sits at 4 rather than the 'minimal conflict risk' of 5.

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

bojieli/ai-agent-book

Path

skills/loop-engineering/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.