# Antigravity Marketing Lab

> Workshop project demonstrating Google Antigravity CLI for agent-first marketing workflows with local-marketing-agent skill for generating campaign headlines

- Skill: `aradotso-marketing-skills/antigravity-marketing-lab` (Agent Skill)
- Install (CLI): `npx skillmds@latest add aradotso-marketing-skills/antigravity-marketing-lab`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aradotso-marketing-skills/antigravity-marketing-lab/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: aradotso (https://skillmd.com/u/aradotso-marketing-skills)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/aradotso-marketing-skills/antigravity-marketing-lab

---


# Antigravity Marketing Lab

> Skill by [ara.so](https://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

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

Verify installation:

```bash
agy --version
```

### Clone the Project

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

### Authenticate

On first run:

```bash
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:

```markdown
# Brief

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

## Core Workflow

### 1. Prepare Your Brief

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

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

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

### 2. Launch Antigravity CLI

```bash
cd antigravity-marketing-lab
agy
```

### 3. Execute Agent Task

In the Antigravity CLI, enter:

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

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

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

### 4. Review Output

```bash
cat outputs/my-headline.md
```

Expected format:

```markdown
# 主標題

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

## Local Marketing Agent Skill

### Viewing the Skill

```bash
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

```text
# 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

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

### Iterate on Output

In `agy` CLI:

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

### Explain Integration Plan

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

請不要實際修改檔案。
```

### Generate Multiple Variations

```text
使用 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:

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

### Custom Skill Installation

To add your own marketing skill:

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

Example custom skill structure:

```markdown
---
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

```bash
# 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

```bash
# Generate all stages at once
agy
```

```text
請依序執行：
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:

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

```text
使用 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:

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

### Skill Not Found

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

**Solution**:

```bash
# 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`:

```bash
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**:

```bash
# 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:

```bash
# 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:

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

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

## Workshop Extensions

### After Completing Stage 1

Try these progressions:

```bash
# 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

```bash
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

```bash
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

```bash
# 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

```bash
#!/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
```

## References

- [Antigravity CLI Documentation](https://antigravity.google/cli)
- [Original Workshop Repository](https://github.com/jarsing/antigravity-marketing-lab)
- [GDG Changhua Build with AI 2026](https://gdg.community.dev/gdg-changhua/)