Content
56%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 body is clearly structured with a sensible workflow and useful command vocabulary, but it is an instruction skill whose referenced reference files and routing table do not exist in the bundle, and the guidance stays at a pseudocode level rather than giving executable command details.
Suggestions
Provide the missing reference files (video_qa.md, social_research.md, etc.) or inline the routing table that maps each of the 6 intent categories to a workflow so the disclosure structure is real.
Add concrete command signatures or example request/response for the named API commands (caption_video, chat_video, search_public) instead of arrow-pseudocode workflows.
Collapse the duplicate "When to Use" / "When to Use This Skill" sections and remove the restated Description section to tighten token usage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient but redundant: "When to Use" and "When to Use This Skill" overlap, the "Description" section restates the frontmatter, and "Unlike one-shot video analysis tools..." is promotional padding. | 3 / 5 |
Actionability | Named commands (caption_video, chat_video, search_audio, memory_add, search_public, wait) give some concrete guidance, but workflows are expressed as pseudocode arrows ("uploads video -> waits -> uses chat_video") with no signatures, parameters, or example requests/responses. | 3 / 5 |
Workflow Clarity | "How It Works" sequences Intent Detection -> Reference Loading -> Workflow Execution, and the upload -> wait -> analyze -> present flow has an explicit validation checkpoint ("Always use the wait command after upload before any analysis"), with Common Pitfalls as feedback guidance. | 4 / 5 |
Progressive Disclosure | Sections are well organized and reference files are named (video_qa.md, social_research.md), but no references/ bundle exists so those paths are dangling, and the promised "routing table in SKILL.md" is not actually present in the body. | 3 / 5 |
Total | 13 / 20 Passed |