CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

conversion-value-mapper

Use when the user asks to "set up conversion values so tROAS optimizes profit not orders", "map margin onto my purchase value", "build value rules for lead / phone / signup conversions", or "stop bidding to revenue when I care about profit"; defines and QAs the conversion VALUE model — per-conversion values, margin/net-value adjustment, static-vs-dynamic value rules, proxy values for non-revenue actions, and a value-vs-count sanity check — as a value-model spec plus a pre-launch value QA sheet. Not for whether the tag fires or UTMs are clean — use conversion-signal-qa; not for cross-platform double-count de-dup — use attribution-reconciler; not for scoring R1/R2 — that is a scored veto in ad-account-auditor. 付费广告转化价值建模/利润出价/价值规则QA

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 highly actionable, well-sequenced instruction skill with concrete formulas, labeling rules, and validation gates — the workflow is essentially copy-executable for an analyst agent. Its main weakness is redundancy: the sibling-skill boundary statement is repeated about five times across the body, spending tokens without new information, and its references lean on external files outside the bundle.

Suggestions

State the scope boundary (plumbing → conversion-signal-qa, R1/R2 scoring → ad-account-auditor, de-dup → attribution-reconciler) once — in the intro scope line — and reduce step 1, step 7, Reference Materials, and Next Best Skill to a short back-reference; this directly addresses the conciseness redundancy.

Consolidate the four per-skill links in Reference Materials with the Next Best Skill section so each sibling is described exactly once, cutting the duplicated routing prose.

Clarify or inline-verify the deeply-relative external references (../../../references/skill-contract.md, ../../../CONNECTORS.md, ../../../SECURITY.md) — either confirm they ship with the skill's distribution repo or move the one sentence of needed content inline.

DimensionReasoningScore

Conciseness

The skill-scope routing (conversion-signal-qa owns plumbing, ad-account-auditor scores R1/R2, attribution-reconciler owns de-dup) is restated nearly verbatim in the intro scope line, step 1, step 7, the Reference Materials section, and Next Best Skill. Anchor 3 ("includes some unnecessary explanation or could be tightened") fits: the repetition is more than the 'minor instances' of anchor 4, though the rest of the body is lean with no padding or explanations of known concepts.

3 / 5

Actionability

Fully actionable instruction-only guidance: explicit formulas ("net_value = revenue × margin (or revenue − COGS)", "proxy_value = avg_order_net_value × lead→sale close_rate"), a labeling taxonomy (Measured/User-provided/Estimated), needs-input states instead of guesses, a concrete failure heuristic ("if the summed conversion value is 3× the real contribution"), and exact write paths. Per the scoring notes, absence of code is not penalized when guidance is this executable; not 4 because there are no minor gaps in the common cases.

5 / 5

Workflow Clarity

Eight numbered steps in dependency order with explicit checkpoints: step 7 runs the value-vs-count reconciliation, step 8 gates on a plain launch-readiness statement, the "Done when" checklist enumerates completion criteria, and error feedback loops route failures (missing margin → needs-input → ask; cross-platform double-count → attribution-reconciler; non-firing event → conversion-signal-qa). Matches the anchor-5 sequence-with-validation-and-feedback-loops pattern.

5 / 5

Progressive Disclosure

The single-file body is well organized (Quick Start, Skill Contract, Data Sources, Instructions, Save Results, Reference Materials, Next Best Skill) with one-level-deep, purpose-annotated references. Not 5 because no bundle files exist and several references resolve to deeply-relative external paths (e.g. "../../../references/skill-contract.md") that are unverifiable from the bundle, a minor organization gap versus the cleanly split anchor-5 example.

4 / 5

Total

17

/

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: concrete capability list, quoted natural-language triggers, explicit when/what, and clear negative boundaries that deconflict three neighboring skills. The only blemish is a redundant trailing Chinese summary line that duplicates content, but it adds no ambiguity and does not dilute the concrete triggers.

DimensionReasoningScore

Specificity

The description enumerates five concrete capabilities — "per-conversion values, margin/net-value adjustment, static-vs-dynamic value rules, proxy values for non-revenue actions, and a value-vs-count sanity check" — plus a concrete deliverable ("a value-model spec plus a pre-launch value QA sheet"). This matches the anchor-5 example listing multiple specific actions with comprehensive coverage; it is not 4 because there are no notable coverage gaps.

5 / 5

Completeness

It explicitly answers 'when' ("Use when the user asks to...") with concrete trigger phrases and 'what' ("defines and QAs the conversion VALUE model") including deliverables, and adds explicit negative scope ("Not for whether the tag fires or UTMs are clean"). This mirrors the anchor-5 example structure; the 'when' is explicit, so the 3-cap for missing trigger guidance does not apply.

5 / 5

Trigger Term Quality

It quotes four natural phrases users would actually say ("set up conversion values so tROAS optimizes profit not orders", "map margin onto my purchase value", "build value rules for lead / phone / signup conversions", "stop bidding to revenue when I care about profit") and covers domain synonyms (tROAS, profit, margin, value rules, lead/phone/signup). Not 4 because synonym and natural-phrase coverage is comprehensive rather than 'a few missing'.

5 / 5

Distinctiveness Conflict Risk

A clear niche (conversion VALUE modeling for value-based bidding) with explicit disambiguation routing wrong-fit requests to sibling skills ("use conversion-signal-qa", "use attribution-reconciler", "a scored veto in ad-account-auditor"). Minimal conflict risk; not 4 because overlap with adjacent skills is explicitly fenced off rather than merely minor.

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: 18 suspicious

Warning

Total

13

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

ad/activate/conversion-value-mapper/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.