ads-plan

Strategic paid advertising planning with industry-specific templates. Covers platform selection, campaign architecture, budget planning, creative strategy, and phased implementation roadmap. Use when user says ad plan, ad strategy, campaign planning, media plan, PPC strategy, or advertising plan.

Quality

75%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./skills/ads-plan/SKILL.md

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 skill provides a comprehensive strategic advertising planning framework with useful templates, tables, and a phased implementation roadmap. Its main weaknesses are verbosity (the opening paragraph and some explanatory text add little value for Claude), lack of truly executable/concrete guidance (it's strategic rather than operational), and missing validation/feedback loops in the workflow. The progressive disclosure structure is reasonable but the main file is too long for an overview.

Suggestions

Remove the abstract opening paragraph about the 'Thinking Framework' and replace with a concise purpose statement—Claude doesn't need philosophical framing to execute a planning skill.

Add explicit validation checkpoints with concrete criteria: e.g., 'Verify tracking by checking real-time reports for test conversions within 24 hours; if no conversions fire, check pixel helper browser extension and server-side event logs before proceeding.'

Define referenced rules inline or in a glossary: '3x Kill Rule' and '20% rule' are mentioned without explanation—either define them briefly or link to a reference file.

Move the detailed tracking setup table and creative production plan into separate referenced files (e.g., TRACKING-SETUP-GUIDE.md, CREATIVE-PLAN.md) to keep SKILL.md as a leaner overview with clear pointers.

Dimension	Reasoning	Score
Conciseness	The opening paragraph about the '10-Principle Thinking Framework' with THINK/CONNECT/FEEL/ACCEPT is abstract filler that doesn't add actionable value. The body is generally well-structured but includes some unnecessary explanation (e.g., describing what content pillars are). Several tables and templates are useful but could be tighter.	2 / 3
Actionability	Provides concrete templates (naming conventions, campaign structure tree, budget tables, tracking setup matrix) which are useful. However, much of the guidance remains at the strategic/planning level without executable specifics—no actual ad platform commands, API calls, or scripts. The campaign architecture and tracking tables are helpful but still require significant interpretation to implement.	2 / 3
Workflow Clarity	The 8-step process and 4-phase implementation roadmap provide clear sequencing. However, validation checkpoints are weak—Phase 2 mentions 'verify conversion tracking is firing correctly' but doesn't specify how. The '3x Kill Rule' and '20% rule' are referenced without definition. No explicit feedback loops for error recovery (e.g., what to do if tracking fails, if CPA exceeds thresholds).	2 / 3
Progressive Disclosure	References to external files are well-signaled (budget-allocation.md, conversion-tracking.md, thinking-framework.md, industry templates in assets/). However, no bundle files are provided, so we cannot verify these references resolve. The SKILL.md itself is quite long (~180 lines of substantive content) and some sections (like the full creative production plan and tracking setup tables) could be split into referenced files to keep the overview leaner.	2 / 3
	Total	8 / 12 Passed

Description

100%

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 well-crafted skill description that hits all the key criteria. It provides specific capabilities, includes a comprehensive set of natural trigger terms, explicitly states both what the skill does and when to use it, and occupies a clear niche in paid advertising planning that distinguishes it from adjacent skills.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: platform selection, campaign architecture, budget planning, creative strategy, and phased implementation roadmap. Also mentions industry-specific templates.	3 / 3
Completeness	Clearly answers both 'what' (strategic paid advertising planning with templates covering platform selection, campaign architecture, etc.) and 'when' (explicit 'Use when' clause with specific trigger phrases).	3 / 3
Trigger Term Quality	Includes a strong set of natural trigger terms users would actually say: 'ad plan', 'ad strategy', 'campaign planning', 'media plan', 'PPC strategy', 'advertising plan'. These cover common variations well.	3 / 3
Distinctiveness Conflict Risk	Clearly scoped to paid advertising planning specifically, with distinct triggers like 'PPC strategy', 'media plan', and 'campaign planning' that are unlikely to conflict with general marketing or content skills.	3 / 3
	Total	12 / 12 Passed

Validation

90%

Warnings & errors only

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

Validation — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: AgriciDaniel/claude-ads
Commit: 283d9d4

Reviewed: about 1 month ago

Table of Contents

Discovery Implementation Validation

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.