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

Performance Hub Data Sources

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

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)
   → Live analytics: impressions, engagements, reach, followers, best posting times, content decay, top posts with links (via Zernio)

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.