Antigravity Marketing Lab

Skill by ara.so — Marketing Skills collection.

This project is a hands-on workshop demonstrating Google Antigravity CLI and agent-first workflows for marketing content generation. It includes a pre-built local-marketing-agent skill that generates localized marketing headlines from structured briefs, designed for events, products, or campaigns targeting Taiwan/Chinese-speaking audiences.

What This Project Does

Provides a complete Antigravity CLI workflow example for marketing tasks
Includes a production-ready agent skill (.agents/skills/local-marketing-agent/SKILL.md)
Demonstrates brief → agent → deliverable pipeline
Shows multi-stage content generation (headline, LINE copy, Facebook posts)
Serves as template for building custom marketing agent skills

Installation

Install Antigravity CLI

curl -fsSL https://antigravity.google/cli/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"

Verify installation:

agy --version

Clone the Project

git clone https://github.com/jarsing/antigravity-marketing-lab.git
cd antigravity-marketing-lab

Authenticate

On first run:

agy

Follow the prompts to authenticate with your Google account.

Project Structure

.agents/
  skills/
    local-marketing-agent/
      SKILL.md              # Agent skill definition
challenge/
  my-brief.md             # Your marketing brief (user fills)
outputs/
  my-headline.md          # Generated headline output
website/
  index.html              # Demo integration site

Key Concepts

Agent Skills

Skills are markdown files in .agents/skills/<skill-name>/SKILL.md that define:

Agent behavior and constraints
Output format requirements
Stage-by-stage workflows
Language and tone guidelines

Brief Format

The challenge/my-brief.md template:

# Brief

- 宣傳主題：彰化在地美食節
- 目標對象：25-45歲在地居民與遊客
- 最大特色或亮點：超過50家老店首次聯合優惠
- 希望對方採取的行動：報名參加導覽、購買聯合票券
- 可以使用的地名或關鍵字：彰化、肉圓、八卦山、古蹟
- 不可以自行添加的資訊：不得捏造折扣金額、名額限制、截止日期

Core Workflow

1. Prepare Your Brief

Edit challenge/my-brief.md with your campaign details:

# View current brief
cat challenge/my-brief.md

# Edit in Cloud Shell editor
cloudshell edit challenge/my-brief.md

2. Launch Antigravity CLI

cd antigravity-marketing-lab
agy

3. Execute Agent Task

In the Antigravity CLI, enter:

請讀取 challenge/my-brief.md，
使用 local-marketing-agent Skill 執行「Stage 1：主標題產生」。

請自行檢查標題是否符合 Skill 規則；
若不符合，請修正後再交付。

最後只將通過檢查的最終主標題
儲存到 outputs/my-headline.md。

4. Review Output

cat outputs/my-headline.md

Expected format:

# 主標題

「彰化美食節｜50家老店聯合優惠，跟著導覽吃遍古城」

Local Marketing Agent Skill

Viewing the Skill

cat .agents/skills/local-marketing-agent/SKILL.md

Key Skill Features

Language: Traditional Chinese (Taiwan)
Stage 1: Main headline (≤24 Chinese characters)
Stage 2: LINE push notification copy
Stage 3: Facebook post opening
Constraints: No fabricated discounts, dates, quotas, or results
Self-validation: Agent checks compliance before delivery

Example Skill Usage Pattern

# Request specific stage
使用 local-marketing-agent 執行 Stage 2：LINE 推播文案

# Multi-stage request
依序執行 Stage 1-3，將所有輸出整合至 outputs/full-campaign.md

# Custom constraints
使用 local-marketing-agent，但將主標題限制改為 16 字以內

Advanced Usage

Check Available Skills

find .agents -name "SKILL.md" -type f

Iterate on Output

In agy CLI:

請改寫 outputs/my-headline.md 中的標題，
加強在地特色感，但仍需符合原 Skill 規則。
更新後儲存回同一檔案。

Explain Integration Plan

根據 outputs/my-headline.md 與 website/ 現有程式，
請只說明如果要把這句主標題整合進首頁 Hero 區塊，
預計需要修改哪些檔案與原因。

請不要實際修改檔案。

Generate Multiple Variations

使用 local-marketing-agent，
根據同一份 brief 產生 3 個不同風格的主標題變化，
儲存至 outputs/headline-variations.md

Configuration

Environment Variables

No API keys required for basic CLI usage. Authentication handled via Google OAuth.

For CI/CD or advanced setups:

export ANTIGRAVITY_PROJECT_ID=your-project-id
export ANTIGRAVITY_REGION=asia-east1

Custom Skill Installation

To add your own marketing skill:

mkdir -p .agents/skills/my-custom-skill
# Create your SKILL.md with frontmatter and instructions

Example custom skill structure:

---
name: email-subject-line-generator
version: 1.0
---

# Task
Generate email subject lines optimized for open rates...

# Rules
- Maximum 50 characters
- Include personalization token: {{name}}
- A/B test variants: 3 versions
...

Common Patterns

Pattern 1: Brief → Headline → Website Integration

# 1. Fill brief
cat > challenge/my-brief.md << 'EOF'
# Brief
- 宣傳主題：夏季限定咖啡新品
- 目標對象：18-35歲咖啡愛好者
EOF

# 2. Generate in agy
agy
# > 使用 local-marketing-agent 執行 Stage 1

# 3. Review
cat outputs/my-headline.md

# 4. Preview integration
grep -A 5 "<h1" website/index.html

Pattern 2: Bulk Campaign Generation

# Generate all stages at once
agy

請依序執行：
1. Stage 1 主標題 → outputs/headline.md
2. Stage 2 LINE 文案 → outputs/line-copy.md
3. Stage 3 Facebook 開頭 → outputs/fb-post.md

每階段完成後自我檢查符合 Skill 規則再繼續。

Pattern 3: Localization Workflow

For multiple regions:

# In my-brief.md
- 可以使用的地名或關鍵字：台中、彰化、南投

使用 local-marketing-agent，
針對台中、彰化、南投三地各產生一版主標題，
分別儲存至 outputs/headline-taichung.md、
outputs/headline-changhua.md、
outputs/headline-nantou.md

Troubleshooting

Agent Doesn't Follow Skill Rules

Symptom: Generated headline exceeds character limit or invents information.

Solution: Add explicit validation step:

請先產生主標題草稿，然後依 SKILL.md 第 X 條檢查：
1. 字數是否 ≤24
2. 是否捏造資訊
若不符合，請修正後再輸出至 outputs/

Skill Not Found

Symptom: Error: skill 'local-marketing-agent' not found

Solution:

# Verify skill exists
find .agents -name "SKILL.md"

# Check you're in project root
pwd  # Should end with antigravity-marketing-lab

# Re-clone if needed
cd .. && rm -rf antigravity-marketing-lab
git clone https://github.com/jarsing/antigravity-marketing-lab.git
cd antigravity-marketing-lab

CLI Not Persisting PATH

Symptom: agy: command not found after closing shell

Solution: Add to ~/.bashrc:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Output File Not Created

Symptom: cat outputs/my-headline.md returns "No such file"

Solution:

# Create outputs directory if missing
mkdir -p outputs

# Re-run agent task with explicit path
agy
# > 確保輸出檔案完整路徑為：$PWD/outputs/my-headline.md

Brief in Wrong Format

Symptom: Agent produces generic output ignoring brief

Solution: Validate brief structure:

# Brief must have these exact fields:
grep -E "^- (宣傳主題|目標對象|最大特色|希望對方採取的行動)" challenge/my-brief.md

# Should return 4+ matches

Rate Limits or Quota Issues

Symptom: 429 Too Many Requests or quota errors

Solution:

Wait 60 seconds between requests
Use --dry-run flag for testing (if available)
Share an account in workshop settings
Simplify task to reduce token usage:

# Instead of multi-stage:
使用 local-marketing-agent 只執行 Stage 1

# Instead of variations:
產生 1 個主標題（不要變化版本）

Workshop Extensions

After Completing Stage 1

Try these progressions:

# Stage 2: LINE copy
agy
# > 使用 local-marketing-agent 執行 Stage 2，儲存至 outputs/line-push.md

# Stage 3: Facebook post
agy
# > 使用 local-marketing-agent 執行 Stage 3，儲存至 outputs/fb-opening.md

Modify Skill Constraints

cp .agents/skills/local-marketing-agent/SKILL.md .agents/skills/local-marketing-agent/SKILL.md.bak

# Edit SKILL.md to change character limits, tone, or rules
cloudshell edit .agents/skills/local-marketing-agent/SKILL.md

Create New Skill

mkdir -p .agents/skills/travel-itinerary-generator
cat > .agents/skills/travel-itinerary-generator/SKILL.md << 'EOF'
---
name: travel-itinerary-generator
version: 1.0
---

# Task
Generate day-by-day travel itineraries for Taiwan destinations...
EOF

Real-World Integration

Export to Marketing Tools

# Copy headline for use in campaigns
cat outputs/my-headline.md | pbcopy  # macOS
cat outputs/my-headline.md | xclip   # Linux

# Export as JSON for API integration
cat > outputs/export.json << EOF
{
  "headline": "$(tail -1 outputs/my-headline.md | tr -d '「」')",
  "campaign_id": "${CAMPAIGN_ID}",
  "timestamp": "$(date -Iseconds)"
}
EOF

Automated Campaign Workflow

#!/bin/bash
# campaign-generator.sh

for city in 台中 彰化 南投; do
  sed "s/彰化/$city/g" challenge/my-brief.md > challenge/brief-$city.md
  
  agy --non-interactive << EOF
請讀取 challenge/brief-$city.md
使用 local-marketing-agent 執行 Stage 1
儲存至 outputs/headline-$city.md
EOF
done

antigravity-marketing-lab

Antigravity Marketing Lab

What This Project Does

Installation

Install Antigravity CLI

Clone the Project

Authenticate

Project Structure

Key Concepts

Agent Skills

Brief Format

Core Workflow

1. Prepare Your Brief

2. Launch Antigravity CLI

3. Execute Agent Task

4. Review Output

Local Marketing Agent Skill

Viewing the Skill

Key Skill Features

Example Skill Usage Pattern

Advanced Usage

Check Available Skills

Iterate on Output

Explain Integration Plan

Generate Multiple Variations

Configuration

Environment Variables

Custom Skill Installation

Common Patterns

Pattern 1: Brief → Headline → Website Integration

Pattern 2: Bulk Campaign Generation

Pattern 3: Localization Workflow

Troubleshooting

Agent Doesn't Follow Skill Rules

Skill Not Found

CLI Not Persisting PATH

Output File Not Created

Brief in Wrong Format

Rate Limits or Quota Issues

Workshop Extensions

After Completing Stage 1

Modify Skill Constraints

Create New Skill

Real-World Integration

Export to Marketing Tools

Automated Campaign Workflow

References