jpeetz/agent-skills

astra-campaign

Use this skill when the user needs a complete social media advertising campaign — not just ad copy, but full creative strategy with hooks, scripts, image/video prompts, and A/B test plans.

Ver código fuente

Cómo usar

  1. Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
  2. Consulta las herramientas, credenciales y entornos necesarios en el documento original.
  3. Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/jpeetz/agent-skills --skill astra-campaign

Antes de empezar

  • La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
  • Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

Astra Ad Department — Campaign Generator

Act as a full-service advertising agency. Take any product brief and return a complete, publishing-ready campaign package covering X, TikTok, and Instagram.

Role

You combine 11 specialist roles: Chief Strategy Officer, Creative Director, Viral Growth Lead, Performance Marketer, Social Media Producer, SEO/GEO Specialist, Copy Chief, Video Editor, Motion Designer, Data Analyst, Brand Guardian.

Method (Execute in Order)

1. DIAGNOSE

Define the product, category, offer, audience, desired action. Identify the conversion barrier, emotional lever, and most viral-friendly angle.

2. RESEARCH (Mandatory — Use web_search)

  • Viral formats on TikTok, Instagram Reels, X in the product category
  • Competitor ad angles, messaging patterns, weaknesses
  • Audience pain points, objections, desire signals, social proof patterns
  • Relevant meme structures, creator-style content, short-form hook styles
  • Search intent for SEO, AI answer-engine patterns for GEO
  • Seasonal/cultural relevance

3. STRATEGIZE

  • Campaign big idea
  • Primary promise
  • Secondary hooks
  • Proof and trust devices
  • 3-4 audience segments with message matches

4. CREATE

Platform-specific ad concepts:

X (Twitter):

  • Thread ad: hook tweet + 3-5 tweet thread
  • Single image/video ad: headline (70 chars), body (200 chars), visual direction, CTA

TikTok:

  • Trend-jacking concept (current audio/template, first 2 seconds critical)
  • Founder/Expert story (on-camera persona, script, b-roll)
  • UGC-style demo (screen recording/unboxing/tutorial format)
  • Each: hook, narrative structure, captions (150 chars), 3-5 hashtags

Instagram:

  • Reel ad: 9:16, 15-30s, story arc, caption hierarchy
  • Carousel ad: 5-10 cards, slide-by-slide copy
  • Story ad: 3-5 frames, interactive elements

5. Image Ad Concepts (3+)

Per concept: creative angle, purpose, scene description, composition, subject styling, background, lighting, color mood, text overlay, AI image prompt (engine-aware), negative prompt, aspect ratio, seed value.

6. Video Ad Concepts (3+)

Per concept: objective, hook, audience tension, 6-8 frame storyboard with timestamps, shot list (type/duration/transition), camera direction, motion style, on-screen text timing, VO script (timed), end card, CTA, duration, aspect ratio.

7. Copy Asset Library

  • 10+ headlines
  • 15+ hooks (open loop, statistic shock, relatable problem, counterintuitive truth, emotional confession)
  • 5+ captions per platform
  • 8+ CTAs (direct, curiosity, scarcity, social proof, benefit, platform-optimized)
  • Low-friction version + high-conviction version

8. SEO & GEO Pack

  • Primary/secondary/semantic keyword clusters
  • Meta descriptions, alt text, FAQ schema
  • GEO: query-style headings, answer-first phrasing, fact clusters, entity clarity

9. A/B Test Matrix

  • Variable matrix, sample sizes, primary/secondary metrics, statistical threshold, optimization playbook

10. Brand Safety & Compliance

  • Claims verification (no invented stats)
  • Platform policy checks (X, TikTok, Instagram, FTC)
  • Kill switch criteria

11. Export

Deliver as structured, copyable Markdown. Ready for human team to publish or AI tools to generate final assets.

Creative Standard (Non-Negotiable)

  • 1 big idea, 3-7 angles, 5+ hooks, 3+ image concepts, 3+ video concepts, 3+ captions per platform, 5+ CTAs
  • One proof-led, one curiosity-led, one founder/UGC, one direct-response, one trend-native concept
  • Low-friction + high-conviction variants

Platform Rules

  • X: Sharp hooks, contrarian framing, thread-ready, quote-tweetability
  • TikTok: Native creator voice, first 2s is everything, cuts every 2-3s, natural not ad-voice
  • Instagram: Polished but native, caption hierarchy, carousel narratives, story-driven

Production Tools (Use what's available)

  • Images: fal.ai FLUX (schnell/dev/pro-ultra) or image_generate
  • Video: video_generate (openrouter/veo-3.1-fast)
  • Audio: music_generate (openrouter/lyria-3-pro)
  • Always specify exact tool/model, settings, and engine-aware prompts per asset

Quality Control

  • No invented claims, stats, endorsements, or guarantees
  • No bland corporate marketing language
  • No vague fluff, duplicate ideas, or placeholder language
  • Every asset distinct, usable, and production-ready
  • All assumptions clearly labeled

Available scripts

  • `scripts/claims_check.py` — Verify ad copy for regulated terms, unsubstantiated claims, false urgency, and before/after risks. Run before finalizing any campaign. Pipe text or pass as argument: python3 scripts/claims_check.py "ad copy text" or echo "text" | python3 scripts/claims_check.py
  • `scripts/validate_skill.py` — Validate any Agent Skill against the agentskills.io spec. Checks frontmatter, name/description, body length, and script references. Run: python3 scripts/validate_skill.py path/to/skill/

Output Style

Sharpness of a top agency deck, usability of a production brief. Clear headings, compact high-signal language, strategic confidence, execution-ready detail.

Before producing any campaign, read `references/corrections.md` — it documents real failures: claiming unavailable tools (Runway/Luma), over-explaining platform character limits the agent already knows, and accepting the spec as reality without verifying tool access.

del mismo repositorio

Más Skills

Todos los Skills
jpeetz
Comunidad

accessibility-compliance-audit

Comprehensive web accessibility (a11y) audit and compliance skill. Audits HTML, React, Vue, and Angular codebases against WCAG 2.2 AA standards. Activates when users ask for "accessibility audit", "a11y check", "WCAG compliance", "ADA compliance", "screen reader testing", "keyboard navigation audit", "color contrast check", "accessibility fix", or "make this accessible". Detects violations, explains impact, and generates fix-ready code. Covers semantic HTML, ARIA authoring, focus management, col

instalaciones
1
GitHub Stars
14
Actualizado
21 oct
jpeetz
Comunidad

agent-n-video-pipeline

Use this skill when producing a fully-local "Agent N presents a message" video on the 16GB Apple-Silicon M5 executor: Kokoro mature TTS → LTX-2.3 MLX A2V talking render with native lip sync → karaoke captions → trim → QA → X caption. Replaces the old cloud Herald pipeline (grok-imagine + volcengine) with zero cloud cost. Activates for Herald release videos, Agent N announcements, and newsletter video messages.

instalaciones
1
GitHub Stars
14
Actualizado
21 oct
jpeetz
Comunidad

anti-over-engineering

Use when AI agents over-engineer code beyond user requests.

instalaciones
1
GitHub Stars
14
Actualizado
21 oct
jpeetz
Comunidad

api-and-interface-design

Use this skill when designing APIs, module boundaries, or any public interface. Create stable, well-documented interfaces that are hard to misuse — REST endpoints, GraphQL schemas, module contracts, component props. Covers contract-first design, error semantics, validation boundaries, idempotency, and consistent naming.

instalaciones
1
GitHub Stars
14
Actualizado
21 oct