Content
58%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable and well-sequenced with strong validation checkpoints and concrete field-level guidance, but it is dense and inlines a large amount of API reference material into SKILL.md rather than using progressive disclosure, and it references internal helper modules that are not present in the bundle.
Suggestions
Move the detailed per-tool parameter and endpoint reference (e.g. Avatar, Lip Sync, Audio/Video Effects, Elements/Account helpers) into separate reference files under references/ and keep SKILL.md as a concise overview with clear one-level-deep pointers.
Either include the referenced helper modules (tools/_kling/media.py, elements.py, account.py) in a scripts/ bundle or rephrase the guidance so it does not depend on files the reader cannot open.
Add at least one complete copy-paste-ready request example (headers + body + poll) for the most common path (e.g. Classic text-to-video) to lift actionability from strong to fully executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's intelligence about the Kling protocol, but it is noticeably long with many inline sections (Auth, Task Protocols, Omni References, multiple parameter blocks) that pack a large amount of reference material into SKILL.md rather than splitting it out; mostly efficient but could be tightened by offloading detail. | 3 / 5 |
Actionability | Provides concrete, executable guidance throughout — specific endpoint paths ('/v1/videos/avatar/image2video'), exact request/response field names ('data.task_id', 'data[0].outputs[]'), and concrete parameter lists ('voice_id', 'voice_language', 'voice_speed'); minor gaps in that no full copy-paste request example is given, but field-level specifics are highly actionable. | 4 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced (e.g. lip sync: identify-face then advanced-lip-sync) with validation/confirmation checkpoints ('stop and return the face list for confirmation unless auto_select_face=True') and explicit error-handling decision rules by code; minor gap is that no explicit re-validate feedback loop is spelled out for the few batch/destructive paths. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) yet the body references internal helper paths ('tools/_kling/media.py', 'tools/_kling/elements.py', 'tools/_kling/account.py') that are not provided as part of the skill, and ~200 lines of API reference are inlined into SKILL.md with section headers rather than split into separate reference files — structure exists but content that should be separate is inlined and references are not backed by real files. | 2 / 5 |
Total | 13 / 20 Passed |