Content
61%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-structured, but redundant pitfall sections and missing validation checkpoints for write/batch operations hold it back from the top band. Tightening duplication and adding explicit verification steps would materially improve it.
Suggestions
De-duplicate the "Known Pitfalls" section — file-type support and node-ID format are already covered in per-workflow pitfalls and Common Patterns; keep one canonical location.
Add explicit validation checkpoints for write/batch operations (verify a comment was posted; check the image-render map for null entries before downloading).
Optionally move the Quick Reference table and detailed per-workflow parameters into a bundled reference file to shorten SKILL.md toward an overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient operational detail Claude would not already know, but the "Known Pitfalls" section duplicates per-workflow pitfalls (file-type support, node-ID dash→colon) and the Quick Reference repeats tool slugs, creating noticeable redundancy. | 3 / 5 |
Actionability | Concrete tool slugs with explicit parameters (file_key, comma-separated ids, depth, scale 0.01-4.0, format options) and per-step pitfalls give mostly executable guidance; the minor gap is the absence of copy-paste MCP tool-call code blocks. | 4 / 5 |
Workflow Clarity | Workflows are clearly numbered with [Prerequisite]/[Required]/[Optional] markers and the Setup validates the connection, but write/batch operations (adding comments, image export) lack explicit validate-and-retry checkpoints, capping this at 3 per the feedback-loop guideline. | 3 / 5 |
Progressive Disclosure | A single well-organized file with clear sections (Prerequisites, Setup, five Core Workflows, Common Patterns, Quick Reference) and no nested references; no bundle files exist, so structure is judged on sectioning, which is good with minor redundancy that could be split out. | 4 / 5 |
Total | 14 / 20 Passed |