CtrlK
BlogDocsLog inGet started
Tessl Logo

feishu-doc

Feishu document read/write operations. Activate when user mentions Feishu docs, cloud docs, or docx links.

87

1.85x
Quality

81%

Does it follow best practices?

Impact

100%

1.85x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

79%

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

This is a strong, actionable API reference skill with excellent conciseness and fully executable JSON examples for every operation. Its main weaknesses are the lack of validation/error-handling workflows for destructive write operations and the fact that all 12+ actions are inlined rather than progressively disclosed across supporting files.

Suggestions

Add a validation/error-handling workflow for write operations, especially for 'write' (which replaces entire document content) — e.g., recommend reading first to confirm the target, and checking the response for errors before proceeding.

Consider splitting detailed table and image operations into a separate reference file (e.g., TABLES_AND_MEDIA.md) to keep the main SKILL.md as a concise overview with links to details.

DimensionReasoningScore

Conciseness

The content is lean and efficient. It doesn't explain what Feishu is or how APIs work—it jumps straight into token extraction, action schemas, and concrete JSON examples. Every section earns its place with no filler.

3 / 3

Actionability

Every action includes a complete, copy-paste-ready JSON payload with specific parameter names and example values. Limitations (e.g., markdown tables not supported) and important notes (e.g., owner_open_id for permissions) are clearly called out.

3 / 3

Workflow Clarity

The 'Reading Workflow' section provides a clear 3-step sequence with a conditional check, which is good. However, there's no validation/error handling guidance for write operations (write, delete_block, create_table), and no feedback loops for potentially destructive operations like 'write' which replaces the entire document.

2 / 3

Progressive Disclosure

The content is well-organized with clear section headers and a logical progression from simple to complex actions. However, at ~150 lines with detailed JSON examples for 12+ actions, some content (e.g., table operations, image upload details) could be split into referenced files. As a standalone file with no bundle, it's a borderline monolithic reference.

2 / 3

Total

10

/

12

Passed

Description

82%

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 functional and covers the basics well, with explicit trigger terms and a clear 'when' clause. Its main weakness is the lack of specific concrete actions beyond the generic 'read/write operations,' and some trigger terms like 'cloud docs' and 'docx links' could cause overlap with other document skills.

Suggestions

Replace 'read/write operations' with specific actions like 'read content, create documents, update text, insert blocks' to improve specificity.

Qualify 'cloud docs' and 'docx links' more precisely (e.g., 'Feishu cloud docs', 'Feishu docx links') to reduce conflict risk with other document-handling skills.

DimensionReasoningScore

Specificity

Names the domain (Feishu documents) and mentions 'read/write operations' as actions, but doesn't list specific concrete actions like creating, editing, formatting, or extracting content from documents.

2 / 3

Completeness

Clearly answers both 'what' (Feishu document read/write operations) and 'when' ('Activate when user mentions Feishu docs, cloud docs, or docx links'), with explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes natural keywords users would say: 'Feishu docs', 'cloud docs', 'docx links'. These cover common variations of how users refer to Feishu documents.

3 / 3

Distinctiveness Conflict Risk

'Cloud docs' and 'docx links' could overlap with other document-handling skills (e.g., Google Docs, general document processing). 'Feishu' is distinctive, but the other trigger terms introduce some conflict risk.

2 / 3

Total

10

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
qsimeon/openclaw-engaging
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.