reddit-ads
Reddit Ads API - campaigns, targeting, conversions, agentic optimization
38
37%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/reddit-ads/SKILL.mdQuality
Discovery
32%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 the domain (Reddit Ads API) and lists broad capability areas but lacks concrete action verbs, explicit trigger guidance ('Use when...'), and sufficient keyword coverage. It reads more like a topic tag list than a functional skill description, making it difficult for Claude to confidently select this skill over others in a large skill library.
Suggestions
Add explicit trigger guidance, e.g., 'Use when the user asks about Reddit advertising, Reddit Ads API, creating or managing Reddit ad campaigns, or tracking Reddit ad conversions.'
Replace the noun list with concrete action phrases, e.g., 'Creates and manages Reddit ad campaigns, configures audience targeting, tracks conversion events, and optimizes ad performance via the Reddit Ads API.'
Include additional natural trigger terms users might say, such as 'Reddit advertising', 'promoted posts', 'ad spend', 'Reddit marketing', or 'ROAS'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Reddit Ads API) and lists some areas (campaigns, targeting, conversions, agentic optimization), but these are high-level categories rather than concrete actions. No verbs describing what the skill actually does (e.g., 'create campaigns', 'configure targeting rules', 'track conversions'). | 2 / 3 |
Completeness | Partially addresses 'what' through listing topic areas but lacks any 'when' guidance. There is no 'Use when...' clause or equivalent explicit trigger guidance, and per the rubric this should cap completeness at 2, but the 'what' itself is also weak (no concrete actions), so a score of 1 is appropriate. | 1 / 3 |
Trigger Term Quality | Includes relevant keywords like 'Reddit Ads', 'campaigns', 'targeting', 'conversions' that users might naturally mention, but misses common variations like 'ad groups', 'Reddit advertising', 'ad spend', 'ROAS', 'Reddit marketing', or 'promoted posts'. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'Reddit Ads API' specifically is fairly distinctive and unlikely to conflict with generic advertising skills, but terms like 'campaigns', 'targeting', and 'conversions' are shared across many ad platform skills (Google Ads, Facebook Ads, etc.), creating some overlap risk. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is a comprehensive but extremely bloated reference that duplicates nearly every code example in both Python and TypeScript, resulting in massive token waste. While the code is highly actionable and executable, the monolithic structure with no file decomposition and the inclusion of boilerplate that Claude could easily generate (OAuth flows, basic CRUD clients, Docker configs) makes this a poor use of context window. The skill would benefit enormously from being split into a concise overview with references to separate files for each major section.
Suggestions
Split into multiple files: keep SKILL.md as a concise overview (~100 lines) with the API hierarchy, key concepts, and links to separate files like AUTH.md, CLIENT.md, CONVERSIONS.md, OPTIMIZER.md
Choose one language for examples (or provide only the most critical example in both) rather than duplicating every code block in Python and TypeScript
Remove content Claude can generate on demand: basic OAuth flows, CRUD client wrappers, Docker boilerplate, and MSW mock setup are all standard patterns that don't need to be in a skill file
Add validation checkpoints to the campaign creation workflow (e.g., verify campaign creation response before proceeding to ad group creation, check for error responses)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~1500+ lines. Provides full client implementations in both Python and TypeScript (duplicated), full OAuth flows in both languages, complete API endpoint tables, full optimizer services in both languages, multi-agent architecture, Docker deployment, and mock test setup. Most of this is boilerplate Claude could generate on demand. The dual-language duplication alone doubles the token cost without adding proportional value. | 1 / 3 |
Actionability | The code examples are fully executable and copy-paste ready with complete type definitions, working OAuth flows, client implementations, and end-to-end workflow examples. Specific API endpoints, payload structures, and configuration values are all concrete and usable. | 3 / 3 |
Workflow Clarity | The complete workflow example shows a clear 3-step campaign creation sequence, and the optimizer has a clear fetch→analyze→execute→log cycle. However, there are no validation checkpoints (e.g., verify campaign was created successfully before creating ad group, check API response status), no error recovery feedback loops in the main workflow, and destructive operations like pausing ads lack confirmation steps. | 2 / 3 |
Progressive Disclosure | Everything is in a single monolithic file with no references to external files. The API endpoint reference tables, full client implementations in two languages, the complete optimizer service in two languages, Docker deployment configs, and multi-agent architecture could all be split into separate referenced files. With no bundle files provided, this is a massive wall of content with no progressive disclosure structure. | 1 / 3 |
Total | 7 / 12 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 — 9 / 11 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 | 9 / 11 Passed | |
- Repository
- alinaqi/claude-bootstrap
- Commit
65efb33
- 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.