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-engineered operational skill body: highly actionable workflows with genuine validation gates (cost confirmation, tier detection, error-recovery table) and clean on-demand reference structure. Its weakest points are the padded, time-sensitive 2026 news block and its total dependence on reference files stored outside the skill directory.
Suggestions
Move the dated 'AI & 2026 context' news block into a reference file (or trim it to one line with a pointer), keeping volatile dates and version-specific API changes out of the always-loaded body.
De-duplicate the reference listing: keep the consolidated Reference Files index and shorten the per-section 'Load:' lines to just the filename.
Co-locate the referenced files within this skill (e.g., ./references/) or document the ../seo dependency explicitly so the skill is self-contained and its reference paths are verifiable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient (tables, terse numbered workflows, a compact error-handling table), but the 'AI & 2026 context' blockquote inlines ~10 lines of dated, time-sensitive news (Ask Maps launch dates, I/O 2026 stats, GBP API additions with source URLs) that will rot and is not placed in a deprecated/old-patterns section, which the guidelines explicitly penalize; the inline 'Load:' lines also duplicate the consolidated Reference Files list. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' better than the minor-trim anchor. | 3 / 5 |
Actionability | Guidance is fully executable: exact tier-detection tool name ('business_data_business_listings_search'), the SoLV formula '(top_3_count / total_points) * 100', a copy-paste cost-warning template, a concrete Bing WebFetch URL, an exact output-file naming convention with JSON field spec, verbatim user-facing error messages, and 2+-of-6 fake-review heuristics — copy-paste-ready and covering the common cases. | 5 / 5 |
Workflow Clarity | All seven workflows are clearly sequenced, and the one risky batch operation (49 paid geo-grid API calls) has an explicit validation checkpoint (cost estimate + user confirmation before proceeding); the six-scenario error-handling table supplies feedback loops for error recovery, and multi-location ambiguity asks the user first. This matches the anchor with explicit validation steps and error-recovery loops. | 5 / 5 |
Progressive Disclosure | Structure is good: per-section 'Load:' signals, a consolidated on-demand Reference Files index with an explicit 'do NOT load all at startup' rule, and one-level-deep references. However, all seven referenced files live outside the skill package ('../seo/references/', shared with seo-local) and no bundle files exist in this skill's directory, so the paths cannot be verified from the skill itself — a structural dependency gap that keeps it below the clear-overview anchor. | 4 / 5 |
Total | 17 / 20 Passed |