Content
71%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, actionable research workflow with a genuinely useful quality checklist, but it is a monolith disconnected from its own bundle: six scripts and a normative output-contract reference exist on disk and are never referenced, and the body's inlined contract contradicts the reference's layout and manifest schema. The deterministic verify_pack.py gate that would anchor the workflow's validation is orphaned.
Suggestions
Resolve the output-contract conflict: either align the body's brand-core/ layout and JSON schema with references/output-contract.md, or update the reference to match — then replace the inlined tree/schema with a pointer like "See [output-contract.md](references/output-contract.md) for the normative layout".
Wire the scripts into the workflow: replace the hand-listed file creation in step 6 with `python scripts/scaffold_brand.py --brand-dir ./<brand>`, reference scripts/fetch_asset.py in the asset steps, and add a final validation step running `python scripts/verify_pack.py --brand-dir ./<brand>` so the ship gate is actually enforced.
Consolidate the repeated optionality language: state once near the top that GooseWorks sync and paid asset generation are optional extensions, and trim the restatements in the inputs list, step 8, and step 9 to cut token overhead.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — no concept tutorials, no filler — e.g., "Do not turn marketing claims into facts. Label them as brand-stated claims until corroborated." Minor trimming is possible: the output tree in "Brand Core output" overlaps with the per-file specs in step 6, and the optionality of GooseWorks sync and paid assets is restated three times ("optional extensions—not prerequisites", "Only when requested", "never required to finish"). That puts it just below the 'every token earns its place' anchor. | 4 / 5 |
Actionability | As an instruction-only skill it gives concrete, executable guidance: exact filenames, a per-file content spec ("sources.md: URL, access date, source type, and which claims it supports"), and a copy-paste-ready brand-core.json template with "Omit unknown values rather than inventing them". A few directives stay high-level — "Use `comment-mining` for relevant public social threads" and "use `competitor-ad-intelligence`" name other skills without any pointer or invocation detail — so it lands at 'mostly executable guidance; minor gaps' rather than fully copy-paste ready. | 4 / 5 |
Workflow Clarity | Nine clearly sequenced steps with real checkpoints: step 1 has an error-recovery loop ("If the site is inaccessible or the identity remains ambiguous, ask for the minimum clarification"), step 7 is a confirmation gate ("Mark low-confidence findings and ask only about material gaps"), and the closing Quality checks act as a checklist. It falls short of the 5 anchor because validation is prose-level only — the bundle ships a deterministic gate (scripts/verify_pack.py, "Exits non-zero and prints every problem found") that the workflow never invokes, leaving a minor validation gap. | 4 / 5 |
Progressive Disclosure | The body itself is well sectioned, but scored against the actual bundle it is poorly wired: references/output-contract.md and all six scripts/ files are never mentioned or linked from the body. Worse, the body inlines its own full output contract (the brand-core/ tree plus a 20-line JSON schema) that conflicts with the normative contract in references/output-contract.md (a brand-research/ folder with brand-summary.md, asset-urls.md, and a manifest.json schema) — content that clearly belongs in the reference file is duplicated inline, and in a divergent form. This matches 'references present but not clearly signaled; content that should be separate is inline' rather than the 2 anchor only because the body's own sectioning is clean. | 3 / 5 |
Total | 15 / 20 Passed |