reddit-ads

Reddit Ads API - campaigns, targeting, conversions, agentic optimization

Quality

47%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

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

Quality

Content

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

The skill is highly actionable with comprehensive executable code and endpoint references, but it is severely over-long due to JS/Python duplication and inlined implementations that belong in separate bundle files. Batch optimization workflows also lack validation safeguards before destructive actions.

Suggestions

Split the full client libraries and optimizer service into separate reference files (e.g. references/client.md, references/optimizer.md) and keep SKILL.md as a concise overview with one-level-deep links.

Pick a single reference language per example (or move the second language into a reference file) to remove the JS/Python duplication that doubles the token budget.

Add a validation/dry-run checkpoint before the optimizer executes destructive recommendations (e.g., preview planned pauses/budget changes and require confirmation) so the batch workflow can score higher on workflow clarity.

Dimension	Reasoning	Score
Conciseness	The body is noticeably verbose (~1980 lines) with every example duplicated in both JavaScript and Python, large ASCII-art boxes, and full client/optimizer implementations inlined that assume little of Claude's competence.	2 / 5
Actionability	It provides mostly executable, copy-paste-ready code and concrete endpoint tables for campaigns, ad groups, ads, conversions, and reporting, with only minor gaps (a few interfaces referenced before definition).	4 / 5
Workflow Clarity	Sequences exist (campaign -> ad group -> ad; the optimizer fetch -> analyze -> execute cycle), but the agentic optimizer performs batch destructive actions (pausing ads, scaling budgets) without validation or dry-run checkpoints, capping this dimension at 3.	3 / 5
Progressive Disclosure	Everything is inlined into a single monolithic SKILL.md with no bundle files; full client libraries and a long optimizer service that clearly belong in separate reference files are inlined rather than split out.	2 / 5
	Total	11 / 20 Passed

Description

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

The description identifies a clear, distinct niche (Reddit Ads API) and names several capability areas, but it is noun-heavy with no verbs and lacks an explicit 'Use when' trigger clause in the description field itself. It reads more like a tag list than an action-oriented trigger.

Suggestions

Rewrite as action-oriented third person ('Create, manage, and optimize Reddit ad campaigns, ad groups, and ads via the Reddit Ads API').

Add an explicit 'Use when...' trigger clause to the description field, e.g. 'Use when building Reddit ad campaign management or optimization tools'.

Include natural user phrasings and synonyms such as 'Reddit advertising', 'promoted posts', or 'Reddit Ads API' to improve trigger-term coverage.

Dimension	Reasoning	Score
Specificity	The description names the domain and several concrete nouns ('campaigns, targeting, conversions, agentic optimization') but uses no verbs, so it lists areas rather than concrete actions like 'create' or 'optimize campaigns'.	2 / 5
Completeness	It gives a clear 'what' but the description field itself has no 'Use when...' clause (that guidance lives in a separate when-to-use field), so per the rubric completeness is capped at 3.	3 / 5
Trigger Term Quality	It includes relevant natural terms ('Reddit Ads', 'campaigns', 'targeting', 'conversions') but misses common synonyms, file extensions, and the phrasing a user would naturally say.	3 / 5
Distinctiveness Conflict Risk	'Reddit Ads API' carves out a clear niche with distinct triggers and only minor overlap risk with general advertising skills.	4 / 5
	Total	12 / 20 Passed

Validation

87%

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 — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (1983 lines); consider splitting into references/ and linking	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: alinaqi/claude-bootstrap
Path: skills/reddit-ads/SKILL.md
Commit: abc600e

Reviewed: 16 days 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.