Agent Skills

name: brand-engineering description: Orchestrate full brand engineering across SEO, AI Search, Social, Email, Creative (images/video), and Brand Core using Cuppa's 65+ MCP tools. Use when the user mentions brand strategy, content pipeline, multi-channel publishing, brand audit, performance analysis, newsletter, social campaign, content calendar, image generation, video creation, mood board, carousel, visual content, or any cross-channel brand workflow.

Brand Engineering with Cuppa

Cuppa agents operate across 6 channels: SEO, AI Search, Social, Email, Creative, Brand Core. Every workflow starts with brand context and ends with performance measurement.

Channel Map

Channel	Purpose	Primary Tools
SEO	Organic search visibility	research_keywords, create_content, grade_content, optimize_content, publish_content
AI Search	LLM citation visibility	create_knowledge, update_brand_context, get_ai_visibility
Social	Platform distribution	generate_social, generate_social_multi, publish_social, schedule_social, generate_carousel
Email	Newsletter distribution	generate_newsletter, list_newsletters, get_newsletter
Creative	Images, video, mood boards	generate_image, create_video, generate_video_script, generate_mood_board, generate_carousel
Brand Core	Voice, identity, visual style	get_brand, update_brand_context, update_brand_visual_style, generate_mood_board
Performance	Cross-channel measurement	get_brand_performance, get_content_health, get_ai_visibility, get_backlinks
Links	Backlink acquisition + engine	list_link_sites, get_link_stats, get_backlinks, Link Marketplace (UI)
Services	Expert human review	Expert Reviews (UI), available via Authorship subscription

Performance Hub Data Sources

The Performance Hub aggregates data from 7 external sources into a unified view:

Source	What It Feeds
Google Search Console	Organic clicks, impressions, CTR, position, top pages, content decay
Google Analytics 4	Sessions, pageviews, users, engagement metrics
Ahrefs	Domain rating, backlinks, referring domains, Brand Radar, competitor gap
Firehose	Web mentions, brand monitoring across the internet
LLM Tracking	ChatGPT and Google AI Overview citations, prompts, cited pages
DataForSEO	LLM cross-aggregated data, competitor LLM mentions, domain intersection
Late.dev	Social post analytics (impressions, engagements, clicks by platform)

Starting Any Workflow

Always begin with context:

1. list_sites → Get available brands/sites
2. get_brand (site_id) → Load Brand DNA (voice, identity, industry)
3. get_content_strategy (site_id) → Current automation settings

This gives you brand voice, visual identity, and current configuration before any action.

Workflow: Brand Audit

Full-stack brand health check in one conversation:

1. get_brand_performance (site_id)
   → KPIs: organic clicks, impressions, CTR, AI citations,
     social reach, sessions, content grade
   → Brand Visibility Score (organic + AI + content + social)
   → Quick Wins: decaying pages, uncited pages, stale content,
     striking distance keywords

2. get_content_health (site_id)
   → Top pages, content decay, cannibalization

3. get_ai_visibility (site_id)
   → LLM mentions, citation gaps vs competitors

4. get_backlinks (site_id)
   → Domain rating, referring domains (via Ahrefs)

5. get_link_stats
   → Link Engine overview: active sites, URLs indexed

6. get_social_analytics (site_id)
   → Impressions, engagements, top posts (via Late.dev)

7. get_content_calendar (site_id)
   → Upcoming pipeline across articles + social + local

8. list_newsletters (site_id)
   → Recent newsletter performance

Synthesize into a report with:

• Strengths (top-performing channels/content)

• Weaknesses (gaps, decay, low engagement)

• Opportunities (striking distance, uncited pages, citation gaps)

• Recommended actions (specific tool calls)

Workflow: Content Pipeline (SEO + Social + Email)

End-to-end from keyword to multi-channel distribution:

1.  research_keywords (seed terms)
2.  create_content (keyword, site_id)
3.  get_content_status (id) → poll until complete
4.  grade_content (id)
5.  optimize_content (id) → if grade suggests improvements
6.  generate_images_bulk ([id], use_brand_colors: true)
7.  publish_content (id, platform) → push to CMS
8.  generate_social_multi (article_title, article_summary,
    platforms: ["linkedin", "twitter", "threads"])
9.  generate_carousel (site_id, topic, generate_images: true)
    → LinkedIn deep-dive version
10. schedule_social → distribute across optimal times
11. generate_video_script (brief: article_summary,
    format: "tutorial_howto", site_id)
    → Optional: create video for social
12. generate_newsletter (site_id) → if enough articles this week

Workflow: Standalone Social Campaign

Topic-based social without article creation:

generate_social (site_id,
  topic: "Your topic here",
  platform: "linkedin",
  tone: "professional",
  hook_type: "contrarian")

generate_social_multi (site_id,
  topic: "Same topic",
  platforms: ["twitter", "linkedin", "threads", "instagram"])

schedule_social → stagger across days
generate_carousel → LinkedIn deep-dive version

Hook types: curiosity, story, value, contrarian, social_proof

Workflow: Visual Content Production

Create brand-consistent images, videos, and mood boards:

Standalone image generation

generate_image (
  prompt: "Describe the image",
  model: "gpt-image-1",         # or flux-1.1-pro, imagen-4.0, etc.
  aspect_ratio: "16:9",
  site_id: site_id               # uses brand colors automatically
)
list_image_models → see all available models

Article images (bulk)

generate_images_bulk (
  article_ids: ["id1", "id2", "id3"],
  model: "gpt-image-1",
  use_brand_colors: true
)

Video creation (script -> generate -> poll)

1. generate_video_script (
     brief: "Product showcase of our new feature",
     format: "product_showcase",   # 10 formats available
     platform: "instagram",
     site_id: site_id              # brand-aware script
   )
   → Returns: prompt, duration, aspect ratio, shot breakdown

2. create_video (
     prompt: <from script>,
     model: "sora-2",             # or replicate:kling-v2.6
     duration_seconds: 10,
     aspect_ratio: "9:16",
     use_brand_context: true
   )
   → Returns: video ID

3. get_video_status (id) → poll until complete → get URL

Video formats: product_showcase, lifestyle_aesthetic, ugc_style, before_after, cinematic_broll, logo_brand_reveal, tutorial_howto, testimonial_talking_head, seasonal_campaign, abstract_mood

Mood boards (brand visual exploration)

1. create_mood_board (name: "Q2 Campaign", site_id)
2. generate_mood_board (mood_board_id, site_id)
   → Auto-generates images + colors from Brand DNA
3. get_mood_board (id) → view all items (images, colors, fonts)

LinkedIn carousels (slides + images)

1. generate_carousel (site_id,
     topic: "5 Ways to Improve Your SEO",
     slide_count: 8,
     tone: "educational",
     generate_images: true)
2. publish_carousel (site_id, caption, image_urls)
   → Or schedule with scheduled_at parameter

Workflow: Performance Feedback Loop

Data-driven strategy adjustment:

1. get_brand_performance → identify KPI trends
2. get_content_health → find decay + opportunities
3. get_ai_visibility → check citation coverage
4. get_social_analytics → platform performance

Decision framework:
- Striking distance keywords (pos 4-20) → create_content targeting them
- Decaying pages → optimize_content on those articles
- Citation gaps → create_knowledge to improve AI visibility
- Top social platforms → generate_social_multi on those platforms
- Low-engagement platforms → adjust content_strategy defaults

Workflow: Strategy Configuration

Programmatic setup of all automation:

update_content_strategy (site_id, {
  article_defaults: {
    model: "claude-sonnet-4-5",
    generate_ai_images: true,
    target_length: "long"
  },
  social_publishing: {
    enabled: true,
    auto_post_on_publish: true,
    default_platforms: ["twitter", "linkedin"],
    default_tone: "professional",
    generate_images: true
  },
  newsletter: {
    enabled: true,
    cadence: "weekly",
    send_day: "friday",
    send_hour: 9
  },
  automation: {
    default_posts_per_week: 5,
    preferred_publish_days: ["monday", "wednesday", "friday"],
    auto_generate_social_on_publish: true,
    auto_add_to_newsletter: true
  }
})

Tool Quick Reference

Research

research_keywords research_serp research_competitors generate_cluster list_clusters

Content

create_content get_content_status get_content list_contents publish_content delete_content

Grading

grade_content get_content_grade optimize_content fetch_serp_data get_serp_data

Social

generate_social generate_social_multi publish_social schedule_social list_social_posts get_social_post update_social_post delete_social_post generate_carousel publish_carousel list_social_platforms get_social_analytics

Performance

get_brand_performance get_content_health get_ai_visibility get_backlinks

Newsletters

generate_newsletter list_newsletters get_newsletter

Brand

get_brand update_brand_context update_brand_visual_style get_notebook

Knowledge

list_knowledge create_knowledge get_knowledge

Planning

list_planner create_planner_item update_planner_item delete_planner_item get_content_calendar get_content_strategy update_content_strategy

Projects (Bulk)

create_project list_projects get_project export_project

Images

generate_image generate_images_bulk list_image_models

Video

generate_video_script create_video get_video_status delete_video

Mood Boards

list_mood_boards create_mood_board get_mood_board delete_mood_board generate_mood_board

Link Engine

list_link_sites get_link_stats update_link_site bulk_update_link_sites refresh_link_sitemaps get_link_categories create_link_category delete_link_category

Infrastructure

list_sites create_site get_gsc_queries list_models list_image_models chat

Key Patterns

Social: article-based vs standalone

• Article-based: provide article_title + article_summary

• Standalone: provide topic instead

Partial updates: update_content_strategy accepts partial objects. Only send sections you want to change.

Grading loop: Always grade_content after create_content. If score < 70, run optimize_content and re-grade.

Newsletter prereq: generate_newsletter requires at least one completed article in the target week.

AI visibility improvement: Create knowledge sources (create_knowledge) with structured, factual content. This improves how LLMs reference your brand.

Image brand awareness: Pass site_id to generate_image for automatic brand color injection. Use use_brand_colors: true with generate_images_bulk.

Video pipeline: Always start with generate_video_script to get optimized prompts, then pass the result to create_video. Poll get_video_status until complete.

Mood board as creative brief: Use generate_mood_board to auto-create visual direction from Brand DNA, then reference the mood board when generating images/videos for campaigns.

Link Engine for internal linking: Use list_link_sites to see your network, get_link_stats for overview, and refresh_link_sitemaps to re-index after publishing new content.

Link Marketplace (UI only): Browse guest post and link insertion opportunities from 1000s of publishers. Filterable by DR, traffic, price, language, region, category. Available at /link-marketplace in the app. Powered by FatGrid.

Expert Reviews (UI only): Request human expert reviews of your articles from industry specialists. Available via the Authorship subscription add-on. Experts are matched by industry from your Brand DNA.