aradotso 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-runflag 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