CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bid-strategy-planner

Use when the user asks to "pick a bid strategy", "set a tCPA/tROAS target", or "plan the learning-phase entry"; produces a bid-strategy choice (tCPA / tROAS / max-conversions / manual CPC), the starting target math, a portfolio grouping map, and a learning-phase entry plan. Not for splitting the budget across campaigns — use budget-optimizer; not for in-flight pacing/scale moves — use budget-pacing-monitor; not for scoring the account — use ad-account-auditor. 出价策略/tCPA目标/tROAS/学习期

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

96%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered instruction-only skill: the body is an actionable overview with a sequenced workflow, explicit decision gates, and completion criteria, while the numeric decision logic is correctly pushed to a real, well-organized one-level-deep reference file. The main weaknesses are mild — repeated contract clauses across sections and a number of links that point outside the bundle and are unverifiable in isolation.

Suggestions

State the Measured / User-provided / Estimated labeling rule once (e.g., in the Skill Contract or Instructions step 3) and drop the restatements in Data Sources and Save Results, cutting ~15% of the body without losing guidance.

Consolidate the budget-pacing-monitor boundary to one place (Next Best Skill) instead of repeating it in the intro paragraph and Instructions step 5, keeping step 5 to a brief pointer.

For standalone robustness, verify that the out-of-bundle links (../../../references/skill-contract.md, ../../../CONNECTORS.md, ../../../SECURITY.md, sibling SKILL.mds) resolve in the published layout, or inline one-line summaries of the handoff-summary shape and security rule so the skill degrades gracefully when they don't.

DimensionReasoningScore

Conciseness

The body is dense and assumes domain competence (never explains what tCPA or a learning phase is), but several contract points are repeated across sections: the Measured/User-provided/Estimated labeling rule appears in Skill Contract, Instructions step 3, Data Sources, and Save Results, and the budget-pacing-monitor boundary is restated three times (intro, step 5, Next Best Skill). This fits the score-4 anchor ('efficient; minor instances of over-explanation that could be trimmed') rather than 5, since a tightened pass could cut roughly 15–20% of restated clauses; it is well above 3 because nothing explains concepts Claude already knows.

4 / 5

Actionability

Every instruction is executable: step 2 delegates to a concrete selection matrix, step 3 specifies the derivation direction ("start at or slightly above the achievable CPA, not the aspirational one") with formulas in the reference (starting_tCPA ≈ trailing_CPA × 1.0–1.1), step 4 links a portfolio-grouping template, and Save Results gives an exact path pattern (memory/ad/bid-strategy-planner/YYYY-MM-DD-<campaign>.md). For an instruction-only skill this is fully actionable guidance with Quick Start examples covering the common cases, matching the score-5 anchor; score 4 would apply if key execution details were missing, but thresholds, formulas, labels, and templates are all specified.

5 / 5

Workflow Clarity

A clear six-step sequence with explicit checkpoints: the Decision Gate provides input validation with error-recovery branches ("Stop and ask" with two concrete options vs. "Continue silently" with stated assumptions), and the "Done when" list is an output-validation checklist (strategy named with rationale, target derivation labeled, entry plan naming conversions-to-exit and the do-not-touch window). This matches the score-5 anchor (clear sequence, explicit validation, feedback loops); no destructive or batch operations are involved, so no cap applies.

5 / 5

Progressive Disclosure

The split is appropriate: SKILL.md stays an overview while the heavy material (selection matrix, thresholds, formulas, checklists) lives one level deep in references/bid-strategy-matrix.md, which exists in the bundle and is clearly signaled with descriptive link text ("strategy-selection thresholds, target-derivation formulas, portfolio grouping template, and learning-phase entry checklist"). It falls short of 5 because many body links (skill-contract.md, state-model.md, CONNECTORS.md, SECURITY.md, roas-benchmark.md, sibling SKILL.mds) point outside the bundle and cannot be verified from it, and the reference file itself links further outward (roas-benchmark.md, budget-pacing-monitor), creating minor navigation uncertainty — 'mostly clear; minor organization gaps' (score 4).

4 / 5

Total

18

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: explicit trigger phrases for when to use it, a fully enumerated list of what it produces, and explicit not-for boundaries that route adjacent tasks to sibling skills. It uses third person, stays concise for its density, and carries no vague or padded language.

DimensionReasoningScore

Specificity

The description enumerates concrete, specific outputs — "produces a bid-strategy choice (tCPA / tROAS / max-conversions / manual CPC), the starting target math, a portfolio grouping map, and a learning-phase entry plan" — which matches the anchor for multiple specific concrete actions with comprehensive coverage. It exceeds the score-4 anchor ('lists several specific actions; minor gaps') because every deliverable of the skill is named, including the strategy options themselves; nothing is vague or generic.

5 / 5

Completeness

It explicitly answers both questions: "when" via the leading "Use when the user asks to..." clause with concrete trigger phrases, and "what" via the enumerated outputs (strategy choice, starting target math, portfolio grouping map, learning-phase entry plan). This mirrors the score-5 anchor example structure exactly; score 4 would apply only if the 'when' were less explicit, but here three quoted trigger phrases are given.

5 / 5

Trigger Term Quality

It quotes three natural user phrasings — "pick a bid strategy", "set a tCPA/tROAS target", "plan the learning-phase entry" — plus the domain terms (tCPA, tROAS, max-conversions, learning phase, portfolio) and Chinese equivalents (出价策略/tCPA目标/tROAS/学习期), giving comprehensive natural-term coverage with synonyms in two languages. This matches the score-5 anchor; score 4 ('a few natural terms missing') would understate coverage, since even colloquial variations like "choose a bidding strategy" or "target CPA" are effectively captured by the quoted phrases and abbreviations.

5 / 5

Distinctiveness Conflict Risk

Three explicit negative boundaries disambiguate it from sibling skills — "Not for splitting the budget across campaigns — use budget-optimizer; not for in-flight pacing/scale moves — use budget-pacing-monitor; not for scoring the account — use ad-account-auditor" — giving it a clear niche with minimal conflict risk. This is stronger than the score-4 anchor ('mostly distinct; minor overlap risk') because the routing away from adjacent skills is stated, not just implied by a narrow trigger.

5 / 5

Total

20

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 15 suspicious

Warning

Total

13

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

ad/orchestrate/bid-strategy-planner/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.