Content
78%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 highly actionable with concrete commands, URLs, exit codes, and retry loops, and the publish workflow is clearly sequenced with validation. It loses points on conciseness (dated postmortems and duplicated strategy notes) and progressive disclosure (monolithic file plus a referenced doc that is absent from the bundle).
Suggestions
Extract the dated incident notes (2026-07-17 get-link, 2026-08-04 _check_logged_in mute) into a short 'CHANGELOG / historical context' reference file or a clearly labeled deprecation block so they stop competing with the main instructions.
Provide the referenced docs/post-deploy-verification.md (or drop the dead link) so the bundle's navigation resolves; consider moving the Pitfalls and Notes sections into a separate reference file.
Deduplicate the aweme_id capture explanation — it currently appears both in the get-link note and the 'aweme_id 捕获 + debug 日志' section — keeping it in one place.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient prose, but several dated incident postmortems (2026-07-17, 2026-08-04) and repeated explanations of the aweme_id capture strategy across sections pad the body; could be tightened without losing meaning. | 3 / 5 |
Actionability | Fully executable: copy-paste ready bash commands for open-page, run, upload/fill/publish/get-link, plus concrete URLs, exit-code tables, and selector-level detail that cover the common cases. | 5 / 5 |
Workflow Clarity | Clear multi-step sequence (open-page → login check → run, or stepwise upload→fill→publish→get-link) with explicit validation via exit codes, retry/backoff guidance for work_list status_code=8, and fail-first session handling — feedback loops present for this batch/network-fragile operation. | 5 / 5 |
Progressive Disclosure | The body has reasonable section structure but is a single long SKILL.md with no reference files split out; it points to docs/post-deploy-verification.md which is not present in the bundle, so navigation is partly dangling. | 3 / 5 |
Total | 16 / 20 Passed |