Content
81%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.
A well-structured, action-oriented operating manual that respects Claude's intelligence and embeds the right validation safeguards for destructive ad-account mutations. The main improvement opportunity is adding a local reference file for the denser platform-interpretation rules to improve progressive disclosure.
Suggestions
Move the platform-interpretation rules (currency units, API code semantics, rate limits, timezone/reporting lag) into a local references file and link to it, keeping SKILL.md as a leaner overview.
Add one concrete example of the preview/apply/read-back write cycle with representative entity fields to strengthen actionability for the safe-mutation workflow.
Clarify which read capability to use for the initial 'harmless account/setup read' so the diagnose step is unambiguous across connector versions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive with platform-specific gotchas ('currency units, not micros', 'API code must be zero even when HTTP is 200', 'long IDs must be preserved as strings'), with only minor phrasing that could be trimmed. | 4 / 5 |
Actionability | Concrete, executable guidance is given throughout ('Resolve `~~tiktok-ads`', 'Record the advertiser currency, timezone, objective...', 'Preview, obtain approval, apply once, then read back'), though it is instruction-only with no literal code or commands. | 4 / 5 |
Workflow Clarity | A clearly sequenced three-phase process (establish scope, diagnose, execute) with explicit validation checkpoints — approval before mutation, read-back after, rollback triggers, and 'stop before claiming live access' on authorization failure — satisfying the destructive-operation feedback-loop requirement. | 5 / 5 |
Progressive Disclosure | Well-organized sections with clearly signaled one-level-deep references at the top ('../shared/operating-contract.md', '../shared/measurement-framework.md', '../../docs/mcp-connection.md'), though those references point outside the skill's own bundle rather than to local reference files. | 4 / 5 |
Total | 17 / 20 Passed |