CtrlK
BlogDocsLog inGet started
Tessl Logo

paid-ads

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ad copy,' 'ad creative,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' or 'audience targeting.' This skill covers campaign strategy, ad creation, audience targeting, and optimization.

60

Quality

70%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./config/claude/skills/paid-ads/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%

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

This is a comprehensive paid advertising skill that covers the full campaign lifecycle from planning through optimization. Its main strengths are good structural organization with tables and clear sections, plus appropriate references to external files for deeper content. However, it's overly verbose for a skill file (much of this is general marketing knowledge Claude already knows), lacks truly executable/actionable guidance (no platform-specific API calls or scripts), and the referenced bundle files don't exist, undermining the progressive disclosure strategy.

Suggestions

Significantly trim general marketing knowledge (ad copy frameworks, creative best practices, common mistakes) that Claude already knows, and focus on project-specific conventions, tool configurations, and decision trees unique to this workflow.

Add concrete, executable examples such as specific platform API calls, UTM parameter templates with actual format strings, or scripts for pulling performance data — the current content is strategic guidance rather than actionable instructions.

Create the referenced bundle files (ad-copy-templates.md, audience-targeting.md, platform-setup-checklists.md) and move the detailed inline content (retargeting tables, creative testing hierarchy, reporting checklists) into them to reduce the main file's length.

Add an explicit end-to-end workflow with numbered steps and validation checkpoints, e.g., '1. Verify tracking → 2. Launch with test budget → 3. Confirm conversions firing within 24h → 4. Scale if CPA meets target after 50+ conversions.'

DimensionReasoningScore

Conciseness

The skill is reasonably well-organized but includes substantial content that could be more concise. The platform selection guide, creative best practices, and common mistakes sections contain general marketing knowledge Claude already possesses. Tables like retargeting windows and funnel stages are useful reference material but the overall document is quite long (~300 lines) with some redundancy (e.g., platform info repeated across multiple tables).

2 / 3

Actionability

The skill provides structured frameworks (PAS, BAB), naming conventions, and checklists which are somewhat actionable, but lacks executable code or concrete platform-specific commands. Most guidance is strategic/conceptual rather than copy-paste ready. The optimization levers and bid strategy sections describe what to do at a high level but don't provide specific implementation steps or exact settings.

2 / 3

Workflow Clarity

There is a logical progression from context gathering → platform selection → campaign structure → optimization → reporting, and the pre-launch checklist provides validation. However, the overall workflow is implicit rather than explicitly sequenced, and there are no feedback loops for campaign launch (e.g., validate tracking fires → launch → check data within 24 hours → adjust). The budget scaling section mentions waiting 3-5 days but lacks explicit checkpoints.

2 / 3

Progressive Disclosure

The skill references several external files (ad-copy-templates.md, audience-targeting.md, platform-setup-checklists.md, tool integrations) which is good progressive disclosure structure. However, no bundle files are provided, meaning all these references are broken/unverifiable. Additionally, a significant amount of content that could be in reference files (creative best practices, retargeting strategies, common mistakes) is inline, making the main file quite long.

2 / 3

Total

8

/

12

Passed

Description

89%

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

This is a strong skill description with excellent trigger term coverage and clear 'when to use' guidance. The main weakness is that the capability descriptions ('campaign strategy, ad creation, audience targeting, and optimization') are somewhat high-level and could be more specific about concrete actions. The description uses appropriate third-person voice and avoids fluff.

Suggestions

Replace the high-level capability list with more specific concrete actions, e.g., 'write ad copy and headlines, define audience segments, set bidding strategies, analyze campaign metrics, create A/B test variants' instead of 'campaign strategy, ad creation, audience targeting, and optimization.'

DimensionReasoningScore

Specificity

The description names the domain (paid advertising) and lists some actions ('campaign strategy, ad creation, audience targeting, and optimization'), but these are fairly high-level categories rather than multiple specific concrete actions like 'write ad copy, set up A/B tests, calculate bid strategies, analyze campaign performance.'

2 / 3

Completeness

Clearly answers both 'what' (campaign strategy, ad creation, audience targeting, optimization across multiple ad platforms) and 'when' (explicit 'Use when' triggers including specific terms and platform mentions). The 'when' guidance is thorough and explicit.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'PPC,' 'paid media,' 'ad copy,' 'ad creative,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' 'audience targeting,' plus platform names like 'Google Ads,' 'Meta,' 'Facebook/Instagram,' 'LinkedIn,' 'Twitter/X.' These are terms users would naturally use.

3 / 3

Distinctiveness Conflict Risk

The description carves out a clear niche around paid advertising specifically, with platform-specific and domain-specific trigger terms (PPC, ROAS, CPA, retargeting) that are unlikely to conflict with other marketing or general content skills.

3 / 3

Total

11

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
freekmurze/dotfiles
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.