CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

attribution-reconciler

Use when platform-reported conversions disagree with GA4/ecommerce, when you suspect Meta and Google are double-counting the same sales, or for a standing (monthly) reconciliation workbook that de-dups stacked credit against an order-ID truth set, normalizes attribution windows and currency, compares attribution models, and reads incrementality from a geo/holdout test. Not for the point-in-time R2 veto or RQS gate — use ad-account-auditor; not for the ROI/ROAS ratio math itself — use roi-calculator; not for organic dark-social share attribution or GA4 direct-traffic decomposition — use dark-social-attributor. 付费广告归因对账/去重/增量

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./ad/scale/attribution-reconciler/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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-structured, highly actionable instruction-only skill with a clearly sequenced workflow and explicit validation gates. Its main weaknesses are redundancy (the same delegation and boundary statements repeated across sections) and reliance on cross-skill references on fragile deep-relative paths with no local bundle files.

Suggestions

State the roi-calculator delegation once (e.g. in the intro and Step 7) and drop the repetitions from 'Done when', Reference Materials, and Next Best Skill, saving several hundred tokens.

Add a short error-recovery branch for the fallback match path — what to do when timestamp+value matching is ambiguous or two platform claims conflict on window/currency normalization.

Give one small inline example of the workbook output (a 3-row match table or the double-count-rate calculation) so the expected shape is concrete without opening external references.

DimensionReasoningScore

Conciseness

The body is mostly efficient procedural prose, but the roi-calculator delegation is repeated five times (intro, 'Done when', Step 7, Reference Materials, Next Best Skill) and the ad-account-auditor non-relation three times, so it could be noticeably tightened. It sits between 'noticeably verbose' (2) and 'efficient' (4) — the padding is redundancy, not over-explanation of known concepts, which keeps it above a 2.

3 / 5

Actionability

Concrete, executable guidance throughout: exact match labels ('matched / double-counted / unmatched'), specific formulas (double-count rate = 'claimed conversions / real orders', lift = 'incremental orders ÷ exposed'), fallback join keys ('order ID... or timestamp + value as a fallback'), and exact memory paths. Minor gaps — the currency 'stated rate' source is unspecified and the attribution-model comparison names models but gives no computation detail — keep it below the fully-specified 5 anchor.

4 / 5

Workflow Clarity

A clear 7-step sequence with an explicit validation gate up front (Step 1 returns 'status: NEEDS_INPUT' if the order-ID export is missing) and a 'Done when' checklist. Not a 5 because there is no error-recovery feedback loop for ambiguous outcomes — e.g. what to do when the timestamp+value fallback match is inconclusive or yields conflicting window normalizations — only that disagreement must be preserved.

4 / 5

Progressive Disclosure

The body is a well-sectioned overview (Quick Start, Skill Contract, Data Sources, Instructions, Save Results, Reference Materials, Next Best Skill) with clearly-signaled, one-level-deep, descriptively-labeled references. The organization gap: no bundle files exist (no references/, scripts/, assets/), and every detail reference is a cross-skill hop on deeply-relative paths (e.g. '../../../references/roas-benchmark.md', '../../orchestrate/ad-test-designer/references/measurement-control.md') that do not resolve from the skill's own directory, so navigation depends on a repo layout the skill doesn't control.

4 / 5

Total

15

/

20

Passed

Description

87%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.

A strong description with explicit 'Use when' triggers, comprehensive concrete actions, and unusually good explicit disambiguation against sibling skills. The only deductions are a second-person phrase and jargon-heavy boundary language that crowds out plainer trigger synonyms.

Suggestions

Rewrite the trigger clause in third person, e.g. 'Use when the user reports that platform conversions disagree with GA4/ecommerce or suspects Meta and Google are double-counting the same sales' to avoid the second-person voice penalty.

Add one or two plainer synonyms (e.g. 'duplicate conversions', 'match reported sales to real orders') alongside the domain jargon so users who don't say 'stacked credit' or 'R2 veto' still trigger the skill.

Trim the negative-scope jargon ('R2 veto', 'RQS gate') from the description and leave those boundary details in when_to_use, where they already exist.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'de-dups stacked credit against an order-ID truth set, normalizes attribution windows and currency, compares attribution models, and reads incrementality from a geo/holdout test' — which approaches comprehensive coverage. However, the second-person phrasing 'when you suspect Meta and Google are double-counting' triggers the rubric's one-point voice penalty; without it this would be a 5.

4 / 5

Completeness

Both what and when are explicitly answered: 'a standing (monthly) reconciliation workbook that de-dups... normalizes... compares... reads incrementality' (what) and 'Use when platform-reported conversions disagree with GA4/ecommerce, when you suspect Meta and Google are double-counting' (when, with concrete trigger phrases). Clearly matches the top anchor.

5 / 5

Trigger Term Quality

Good natural keywords users would actually say — 'platform-reported conversions disagree', 'double-counting the same sales', 'GA4/ecommerce', 'reconciliation'. The insider jargon ('R2 veto', 'RQS gate', 'stacked credit') is boundary guidance rather than triggers, and plainer synonyms like 'duplicate sales' or 'matching conversions to orders' are missing, so not a 5.

4 / 5

Distinctiveness Conflict Risk

The description explicitly fences off three sibling skills — 'Not for the point-in-time R2 veto or RQS gate — use ad-account-auditor; not for the ROI/ROAS ratio math itself — use roi-calculator; not for organic dark-social share attribution... — use dark-social-attributor' — giving it a clear niche with minimal conflict risk.

5 / 5

Total

18

/

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

Warning

Total

13

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

ad/scale/attribution-reconciler/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.