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-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/jpeetz/agent-skills --skill astra-campaign

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

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.

do mesmo repositório

Mais Skills

Todos os Skills
jpeetz
Comunidade

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

instalações
1
GitHub Stars
14
Atualizado
21 de out.
jpeetz
Comunidade

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.

instalações
1
GitHub Stars
14
Atualizado
21 de out.
jpeetz
Comunidade

anti-over-engineering

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

instalações
1
GitHub Stars
14
Atualizado
21 de out.
jpeetz
Comunidade

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.

instalações
1
GitHub Stars
14
Atualizado
21 de out.