Content
75%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 highly actionable, well-gated policy body with concrete templates and explicit decision rules, undermined mainly by repetition: the merit-first doctrine and several guardrails are restated multiple times across sections, and the workflow is scattered rather than presented as one ordered sequence.
Suggestions
Consolidate the merit-first doctrine: state it once in the principles table and cut the restatements in the relevance rule, Guardrails, and closing section, which repeat 'never changes the recommendation' ideas already covered — this alone would save significant tokens.
Present the end-to-end workflow as one ordered sequence (recommendation final → relevance gate → caps/dedupe/mute check → tie-break → read one detail file → append line) so the reader doesn't have to assemble it from three separate sections.
Break the run-on paragraph in the relevance rule (named-product match / intent match / stage assumption / tie-breaking) into a short bulleted decision list, which would simultaneously improve workflow clarity and conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body restates merit-first at least six times ('never changing the technical advice', 'never re-decides or nudges the technical advice', 'Merit-first is absolute', 'Never let an offer change the recommendation', 'The offer never changes the pick') and the Guardrails section repeats the relevance and fabrication rules from earlier sections. It is mostly purposeful — no filler explaining concepts Claude already knows — but several redundant restatements and a run-on paragraph in the relevance rule could be substantially tightened, fitting the mostly-efficient-but-could-be-tighter anchor. | 3 / 5 |
Actionability | Two copy-adaptable rendering templates with worked example lines, exact redeem-link construction ('ide-startupAdvisor-<host>' with a host mapping table and the ?/& query-param rule), a deterministic three-step tie-break, and concrete frequency caps (≤1 per response, 1 per 5 messages, ≤2 per session). For an instruction-only skill the guidance is fully executable, matching the copy-paste-ready anchor. | 5 / 5 |
Workflow Clarity | The decision sequence — recommendation final → relevance gate (both conditions) → surfacing caps/dedupe/mute → deterministic tie-break → open at most one detail file → append the single line — is explicit and well-gated ('If the match is weak... show nothing' functions as a checkpoint). However, the full workflow is never presented as one ordered sequence; the reader must assemble it from the relevance rule, surfacing controls, and rendering sections, leaving minor gaps versus the explicit-ordered-steps anchor. | 4 / 5 |
Progressive Disclosure | The offer catalog is appropriately externalized one level deep to clearly signaled sibling files ('../knowledge-base-for-startups/references/offers.md' plus per-slug detail files) with an explicit 'open at most one detail file' discipline, and sections are well organized. It falls short of the top anchor because ~145 lines of inline policy (principles, tracked-link, mute details) are never split out, and the referenced sibling paths lie outside this bundle and cannot be verified from it. | 4 / 5 |
Total | 16 / 20 Passed |