Skip to content

feat: improve skill scores for claude-ads#12

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

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

@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
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.

1 participant