Skip to content

feat: improve skill scores for claude-ads#12

Closed
popey wants to merge 1 commit intoAgriciDaniel:mainfrom
popey:improve/skill-review-optimization
Closed

feat: improve skill scores for claude-ads#12
popey wants to merge 1 commit intoAgriciDaniel:mainfrom
popey:improve/skill-review-optimization

Conversation

@popey
Copy link
Copy Markdown

@popey popey commented Mar 17, 2026

Hullo @AgriciDaniel 👋

I ran your skills through tessl skill review at work and found some targeted improvements. Here's the full before/after:

Skill Before After Change
ads-landing 79% 100% +21%
ads-competitor 75% 89% +14%
ads-youtube 86% 100% +14%
ads-creative 83% 93% +10%
ads-audit 86% 93% +7%
ads-google 86% 93% +7%
ads-budget 86% 89% +3%

Summary

Improved 7 skills with an average improvement of +7% (average score 85% → 92%). All 18 skills also had their frontmatter description format standardized from YAML block scalars (>) to quoted strings for consistency.

Type of Change

  • Other (describe): Skill quality improvements — workflow clarity, actionability, and frontmatter standardization

Checklist

  • Tested against a sample ad account (if applicable)
  • SKILL.md files are under 500 lines
  • Reference files are under 200 lines
  • Python scripts output valid JSON
  • Shell scripts use set -euo pipefail
  • No credentials or API keys in the diff

Changes made

All 17 sub-skills

  • Standardized frontmatter description from YAML block scalar (>) to quoted string format

ads-landing (+21%)

  • Added validation checkpoints (URL accessibility, tracking pixel verification)
  • Added executable speed test commands (Lighthouse CLI, PageSpeed API)
  • Added conversion tracking verification code snippets
  • Removed truisms, converted mobile checklist to checkbox format

ads-competitor (+14%)

  • Added validation checkpoints (confirm competitors found, verify gap analysis uses real data)
  • Removed redundant platform-specific research section
  • Condensed competitive response strategies into compact playbook

ads-youtube (+14%)

  • Added validation checkpoints (confirm active video campaigns, verify campaign types)

ads-creative (+10%)

  • Added validation checkpoints (confirm platform data, verify fatigue signals)

ads-audit (+7%)

  • Added validation checkpoints (confirm platform data, verify subagent scores)

ads-google (+7%)

  • Added validation checkpoints (confirm 30-day data, verify all 74 checks evaluated)

ads-budget (+3%)

  • Added validation checkpoints (confirm 14-day spend data, verify kill list data sufficiency)

ads (orchestrator)

  • Added concrete subagent spawning example and validation step

ads-apple

  • Added data validation checkpoint (confirm 30-day campaign data)

Honest disclosure — I work at @tesslio where we build tooling around skills like these. Not a pitch - just saw room for improvement and wanted to contribute.

Want to self-improve your skills? Just point your agent (Claude Code, Codex, etc.) at this Tessl guide and ask it to optimize your skill. Ping me - @popey - if you hit any snags.

Thanks in advance 🙏

Hullo @AgriciDaniel 👋

I ran your skills through `tessl skill review` at work and found some targeted improvements. Here's the full before/after:

| Skill | Before | After | Change |
|-------|--------|-------|--------|
| ads-landing | 79% | 100% | +21% |
| ads-competitor | 75% | 89% | +14% |
| ads-youtube | 86% | 100% | +14% |
| ads-creative | 83% | 93% | +10% |
| ads-audit | 86% | 93% | +7% |
| ads-google | 86% | 93% | +7% |
| ads-budget | 86% | 89% | +3% |

## Summary

Improved 7 skills with an average improvement of +7% (average score 85% → 92%). All 18 skills also had their frontmatter description format standardized from YAML block scalars (`>`) to quoted strings for consistency.

## Type of Change

- [x] Other (describe): Skill quality improvements — workflow clarity, actionability, and frontmatter standardization

## Checklist

- [x] Tested against a sample ad account (if applicable)
- [x] SKILL.md files are under 500 lines
- [x] Reference files are under 200 lines
- [x] Python scripts output valid JSON
- [x] Shell scripts use `set -euo pipefail`
- [x] No credentials or API keys in the diff

### Changes made

**All 17 sub-skills**
- Standardized frontmatter `description` from YAML block scalar (`>`) to quoted string format

**ads-landing (+21%)**
- Added validation checkpoints (URL accessibility, tracking pixel verification)
- Added executable speed test commands (Lighthouse CLI, PageSpeed API)
- Added conversion tracking verification code snippets
- Removed truisms, converted mobile checklist to checkbox format

**ads-competitor (+14%)**
- Added validation checkpoints (confirm competitors found, verify gap analysis uses real data)
- Removed redundant platform-specific research section
- Condensed competitive response strategies into compact playbook

**ads-youtube (+14%)**
- Added validation checkpoints (confirm active video campaigns, verify campaign types)

**ads-creative (+10%)**
- Added validation checkpoints (confirm platform data, verify fatigue signals)

**ads-audit (+7%)**
- Added validation checkpoints (confirm platform data, verify subagent scores)

**ads-google (+7%)**
- Added validation checkpoints (confirm 30-day data, verify all 74 checks evaluated)

**ads-budget (+3%)**
- Added validation checkpoints (confirm 14-day spend data, verify kill list data sufficiency)

**ads (orchestrator)**
- Added concrete subagent spawning example and validation step

**ads-apple**
- Added data validation checkpoint (confirm 30-day campaign data)

Honest disclosure — I work at @tesslio where we build tooling around skills like these. Not a pitch - just saw room for improvement and wanted to contribute.

Want to self-improve your skills? Just point your agent (Claude Code, Codex, etc.) at [this Tessl guide](https://docs.tessl.io/evaluate/optimize-a-skill-using-best-practices) and ask it to optimize your skill. Ping me - [@popey](https://github.com/popey) - if you hit any snags.

Thanks in advance 🙏

## Related Issues

N/A
@AgriciDaniel
Copy link
Copy Markdown
Owner

Thanks for this thorough work, @popey! The skill score analysis from Tessl was genuinely helpful.

After detailed review, I've cherry-picked the validation gate improvements from 6 skills:

  • ads/SKILL.md — Task tool orchestration clarity + subagent JSON validation
  • ads-audit — Platform data availability check + subagent score verification
  • ads-budget — 14-day minimum for kill/scale + 20-click/$100 data sufficiency
  • ads-creative — Data existence check + assumption prevention gate
  • ads-google — 30-day data minimum + 74-check completeness verification
  • ads-youtube — Active campaign check + campaign type completeness

Skipped: The YAML frontmatter reformatting (single-line descriptions) and the content compression in ads-competitor and ads-landing. The compression removed valuable platform-specific research instructions (Google Ads Transparency Center, Meta Ad Library steps), Lighthouse CLI commands, and trust element details that users rely on.

These will ship in v1.3.0. Appreciate the contribution and the transparent disclosure about Tessl! 🙌

AgriciDaniel added a commit that referenced this pull request Apr 1, 2026
- Upstream 10 Google Ads audit accuracy fixes from community fork (akarls-web),
  eliminating ~600 false positives across G03, G04, G12, G16, G17, G19, G48, G-CT1
- Cherry-pick 6 validation gates from PR #12 (Tessl) for data quality enforcement
- Add Google Ads MCP integration for optional automated data collection
- Create marketplace.json for plugin system discoverability (Issue #14)
- Add GAQL compatibility reference (gaql-notes.md) with deduplication patterns
  and legacy BMM detection heuristic
- Update Dependabot deps: actions/checkout v6, setup-python v6, Pillow <13.0.0
- Align version to 1.3.0 (was incorrectly 2.0.0 in plugin.json)

PR triage: Closed #4, #5, #13 (out of scope); cherry-picked #12; merged #8, #9, #10
Issues: Closed #14 (marketplace.json shipped)
Community: Replied to Discussion #11

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants