CtrlK
BlogDocsLog inGet started
Tessl Logo

feishu-update-doc

更新飞书云文档。支持 7 种更新模式:追加、覆盖、定位替换、全文替换、前/后插入、删除。

57

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./nexu-skills/skills/feishu-update-doc/SKILL.md

The canonical home for this skill is feishu-update-doc in op7418/CodePilot

SKILL.md
Quality
Evals
Security

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with executable examples for all seven modes and good structural organization. Its gaps are missing post-action validation for destructive/batch operations and a monolithic single-file layout with no progressive disclosure.

Suggestions

Add explicit validation/verification checkpoints after destructive and batch operations (overwrite, replace_all, delete_range), e.g. re-read the located range or confirm replace_count before proceeding.

Split the return-value and per-mode API reference into a reference bundle file, leaving SKILL.md as a concise overview pointing to it.

Trim the 最佳 practices section to avoid re-explaining points already covered in the mode examples.

DimensionReasoningScore

Conciseness

The body is mostly lean — executable JSON examples and concrete rules with no concept padding — but the 最佳实践 section re-explains guidance already implied earlier, so it could be tightened.

2 / 3

Actionability

Every mode ships with complete, copy-paste-ready JSON examples plus parameter specs, return-value shapes, and error formats, matching 'fully executable; copy-paste ready'.

3 / 3

Workflow Clarity

Modes are well-sequenced and a whiteboard-repair feedback loop exists, but destructive/batch operations (overwrite, replace_all, delete_range) lack explicit post-action verification checkpoints, capping workflow clarity at 2.

2 / 3

Progressive Disclosure

No bundle files exist and all content is inline in one ~280-line file; sections are well-organized but return-value/API reference content that could live in a separate file is not split out.

2 / 3

Total

9

/

12

Passed

Description

67%

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 specific and distinctive, naming the Feishu domain and all seven update modes. Its main weakness is the absence of an explicit 'Use when...' trigger clause and common trigger-term variations.

Suggestions

Add an explicit trigger clause, e.g. 'Use when updating or editing Feishu/Lark cloud documents.'

Include common user phrasings like 编辑/修改飞书文档 alongside 更新 to improve trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain (飞书云文档) and lists multiple concrete actions — the 7 modes 追加、覆盖、定位替换、全文替换、前/后插入、删除 — matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

It clearly answers 'what' (updates Feishu docs across 7 modes) but offers no explicit 'Use when...' trigger guidance, so per the guideline completeness is capped at 2.

2 / 3

Trigger Term Quality

'更新飞书云文档' is a natural term a user might say, but common variations like 编辑/修改文档 are absent and the mode names are somewhat technical, fitting 'some relevant keywords but missing common variations'.

2 / 3

Distinctiveness Conflict Risk

Feishu cloud-document updating is a clear, narrow niche with distinct triggers unlikely to collide with unrelated skills.

3 / 3

Total

10

/

12

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.

Validation15 / 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
nexu-io/nexu
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.