engremran07/gsmvault/ads-placement-auto

Claude Code and agent skill by engremran07/gsmvault

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Auto placement: template scanning, AI-discovered positions. Use when: running auto-ads scanner, reviewing scan discoveries, approving AI-suggested placements.

Install

npx vskill@latest install engremran07/gsmvault/ads-placement-auto

SKILL.md

The same SKILL.md was published earlier as engremran07/gsmvault/ads-placement-auto.

Auto Ad Placement

When to Use

  • Running the auto-ads template scanner (scan_templates_for_ad_placements Celery task)
  • Reviewing AutoAdsScanResult and ScanDiscovery records
  • Approving/rejecting AI-suggested placement positions
  • Excluding templates from scanning via TemplateAdExclusion

Rules

  • Scanner creates AutoAdsScanResult per template with review_status = PENDING
  • Each result has multiple ScanDiscovery records (individual placement zones)
  • Discoveries require admin approval before becoming live AdPlacement records
  • Templates in TemplateAdExclusion are always skipped
  • ad_density_warning = True flags templates with too many existing ads
  • Scanner detects viewport zones: above-fold, mid-content, sidebar, footer, sticky

Patterns

Running the Scanner
python
# apps/ads/tasks.py
from celery import shared_task
@shared_task(name="ads.scan_templates")
def scan_templates_for_ad_placements() -> dict:
from apps.ads.services import auto_scan
return auto_scan.run_full_scan()
Processing Scan Results
python
# apps/ads/services/auto_scan.py
from apps.ads.models import AutoAdsScanResult, ScanDiscovery
def approve_discovery(*, discovery_id: int, admin_user) -> ScanDiscovery:
discovery = ScanDiscovery.objects.select_related("scan_result").get(pk=discovery_id)
discovery.status = ScanDiscovery.Status.APPROVED
discovery.reviewed_by = admin_user
discovery.reviewed_at = timezone.now()
# Create the actual AdPlacement from discovery
placement = AdPlacement.objects.create(
name=discovery.placement_name,
slot_id=discovery.placement_code,
is_enabled=False, # Admin enables after review
)
discovery.placement = placement
discovery.save()
return discovery
Excluding Templates
python
from apps.ads.models import TemplateAdExclusion
def exclude_template(*, template_path: str, reason: str, user) -> TemplateAdExclusion:
return TemplateAdExclusion.objects.create(
template_path=template_path,
reason=reason,
excluded_by=user,
)

Anti-Patterns

  • Auto-approving scan discoveries without admin review
  • Scanning HTMX fragment templates — they're partial, not full pages
  • Ignoring ad_density_warning — leads to CLS penalties and bad UX
  • Creating placements directly without going through scanner workflow

Quality Gate

powershell
& .\.venv\Scripts\python.exe -m ruff check . --fix
& .\.venv\Scripts\python.exe -m ruff format .
& .\.venv\Scripts\python.exe manage.py check --settings=app.settings_dev

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/engremran07/gsmvault/ads-placement-auto/badge)](https://verified-skill.com/skills/engremran07/gsmvault/ads-placement-auto)

Something wrong with this skill or its page? Tell us.