CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

context-engineering

设计 Agent 系统提示词、上下文结构或按需加载的 Skill 时使用——覆盖 API 消息角色与「静态前缀 + 轨迹」结构、系统提示词写法(结构化、SOP、业务规则细化、few-shot)、Agent Skills 渐进式披露与 SKILL.md 编写、提示注入的上下文层防御,以及注意力位置偏好等布局原则。

Quality

83%

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

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

A dense, well-organized knowledge reference with concrete prompt examples, quantified pitfalls, and a layout skeleton — genuinely useful to a capable model. Its main weaknesses are the absence of an explicit sequenced workflow with validation checkpoints (it reads as a topic survey rather than an SOP) and references to files that are not part of the skill bundle.

Suggestions

Add an explicit step-by-step procedure with validation checkpoints for the skill's own tasks — e.g., auditing an existing system prompt: check static-prefix stability → apply the four dimensions → verify against the 常见陷阱 checklist → confirm with an ablation run.

Trim or compress the explanations of concepts Claude already knows (message roles, the ReAct loop, Markdown/XML tag semantics) into a single reference line each to reclaim context budget.

Bundle the cited materials (book/chapter2.md, chapter1/context/, chapter2/prompt-engineering/) as actual reference files, or restate the pointers so it is clear they are external resources rather than skill-bundled paths.

DimensionReasoningScore

Conciseness

The body is dense and mostly novel (「任务成功率下降超过 30%」「工具调用错误率增加 45%」「每分钟 $0.05」), but a few one-liners restate basics Claude already knows — the message-role enumeration 「`system`(开发者规则,通常只有一条且在最前)、`user`(终端用户输入)…」, the ReAct loop description, and Markdown/XML tag semantics. Not 3: these are minor, trimmable instances in an otherwise tight document; not 5: they still exist.

4 / 5

Actionability

Mostly concrete, usable guidance: exact prompt examples (`You MUST answer concisely with fewer than 4 lines`, `NEVER use percentage_based_one_time for refunds and service cancellations. Use fixed_fee instead.`), explicit thresholds (「>60% 可退款、<30% 拒绝任务」), and a layout skeleton in code. Not 5: the Python skeleton's functions (`compress_old_evidence`, `make_status_message`) are undefined templates and the flexibility is not explicitly justified.

4 / 5

Workflow Clarity

Organization is thematic (何时使用 → 核心原则 → 实践模式 1–5 → 常见陷阱) rather than a sequenced procedure; there is no explicit step-by-step workflow with validation checkpoints or feedback loops for the design/audit tasks the skill guides. Not 4: no clear sequence of steps for the reader to follow exists; not 2: the thematic structure and when-to-use section do provide rough guidance.

3 / 5

Progressive Disclosure

Clear heading hierarchy with a dedicated 「深度阅读」 section listing one-level-deep references, and the 「配套代码」 section points to companion code. Not 5: cited paths (`book/chapter2.md`, `chapter1/context/`, `chapter2/prompt-engineering/`) and the `kv-cache-design` skill are not bundled with this skill, so the references dangle; not 3: structure and signaling within the file are good.

4 / 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.

The description is a dense, well-scoped routing description: it states explicit 'use when' triggers, enumerates concrete capability areas, and stays within a distinctive niche. Its only weaknesses are a few missing natural synonyms (e.g., prompt engineering, tool definitions) and mild overlap risk with adjacent prompt-writing skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — 「设计 Agent 系统提示词、上下文结构或按需加载的 Skill」「系统提示词写法(结构化、SOP、业务规则细化、few-shot)」「Agent Skills 渐进式披露与 SKILL.md 编写」「提示注入的上下文层防御」「注意力位置偏好等布局原则」— comprehensively covering the skill's scope. Not 4: no meaningful action area is missing.

5 / 5

Completeness

Explicitly answers both: 'what' via the enumerated coverage list (「API 消息角色与「静态前缀 + 轨迹」结构…提示注入的上下文层防御」) and 'when' via the explicit trigger clause 「设计…时使用」 with concrete trigger phrases. Not 4: the 'when' is not merely present but specific and concrete.

5 / 5

Trigger Term Quality

Good keyword coverage with natural terms a user would say — 「系统提示词」「上下文结构」「Skill」「SKILL.md」「few-shot」「提示注入」— but common variations like 「提示工程」/“prompt engineering” and 「工具定义」 (a use case the body itself lists) are absent. Not 5: a few natural synonyms are missing; not 3: coverage goes well beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

A clear niche (context engineering) with distinct triggers like 「渐进式披露」「提示注入的上下文层防御」that few other skills would claim. Not 5: minor overlap risk remains with a dedicated prompt-engineering or SKILL-writing skill, which the phrase 「系统提示词写法」 could also trigger.

4 / 5

Total

18

/

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/context-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.