- name
- lanbow-ads-skills
- description
- |
- homepage
- https://lanbow.com/
- metadata
Lanbow Ads Skills
End-to-end Meta Ads lifecycle management across 4 features: Strategy → Creative → Delivery → Review, forming a continuous optimization loop. Built by Lanbow — see the detailed guide for more information.
Feature Map
| # | Feature | Skill | What It Does | Key Dependency |
|---|---|---|---|---|
| 1 | Strategy Research | ads-strategy-researcher | Market analysis, competitive intelligence, messaging strategy | WebSearch / WebFetch |
| 2 | Creative Generation | creative_gen | AI-generated ad images from strategy inputs | User's Gemini API Key |
| 3 | Ad Delivery | lanbow-ads | Campaign creation and management via Meta Ads CLI | User's Meta Access Token |
| 4 | Post-Campaign Review | post-campaign-review | Performance diagnosis and optimization plan | Campaign delivery data |
System Decision Tree
Starting a new campaign from scratch? → Start at Feature 1 (Strategy) → Feature 2 (Creative) → Feature 3 (Delivery)
Have strategy, need creatives? → Start at Feature 2 (Creative) → Feature 3 (Delivery)
Have creatives, need to launch? → Start at Feature 3 (Delivery)
Campaign already running, need to optimize? → Start at Feature 4 (Review) → loop back to Features 1-3 as needed
Quick ad hoc task? (list campaigns, check performance, upload image, etc.) → Use Feature 3 (Delivery / lanbow-ads CLI) directly
Full Lifecycle Loop
┌─────────────────────────────────────────────────────────┐
│ │
│ Feature 1: Strategy Research │
│ ┌──────────────────────────────────┐ │
│ │ Input: URL, objectives, audience │ │
│ │ Output: insights report │ │
│ │ • key message │ │
│ │ • key look │ │
│ │ • ad angles + CTAs │ │
│ │ • audience segments │ │
│ └──────────┬───────────────────────┘ │
│ │ │
│ ▼ │
│ Feature 2: Creative Generation │
│ ┌──────────────────────────────────┐ │
│ │ Input: key message, key look, │ │
│ │ product info, audiences │ │
│ │ Output: ad images + prompts │ │
│ └──────────┬───────────────────────┘ │
│ │ │
│ ▼ │
│ Feature 3: Ad Delivery │
│ ┌──────────────────────────────────┐ │
│ │ Input: creatives, targeting, │ │
│ │ budget, account │ │
│ │ Output: live campaign │ │
│ └──────────┬───────────────────────┘ │
│ │ │
│ ▼ │
│ Feature 4: Post-Campaign Review │
│ ┌──────────────────────────────────┐ │
│ │ Input: performance data │ │
│ │ Output: diagnosis + next actions │──── loop back ────┘
│ └──────────────────────────────────┘Feature 1: Strategy Research
Skill: ads-strategy-researcher | Details: strategy-research.md
Perform pre-campaign market analysis using WebSearch + WebFetch. Produces a structured strategy report.
Trigger phrases: "ads strategy", "marketing plan", "competitor research", "market research"
Inputs: product URL, business objectives, campaign context, audience info, competitors
Key outputs that feed Feature 2:
| Output | Used By |
|---|---|
| Key Message (primary promise + reasons) | product_info / requirements in creative gen |
| Key Look (visual cues, composition) | requirements in creative gen |
| Ad Angles (hooks, CTAs) | input_cta in creative gen |
| Audience Segments | audience_descriptions in creative gen |
Strategy types: Omni-Channel (Amazon + TikTok + Meta) or Meta-Only
Feature 2: Creative Generation
Skill: creative_gen | Details: creative-generation.md
Generate ad creative images via 2-step Gemini pipeline: proposals (gemini-2.5-flash) → images (gemini-3.1-flash-image-preview).
Trigger phrases: "generate ad", "create ad image", "ad creative", "generate creatives"
Requires: GEMINI_API_KEY (optional env var — only needed when using this feature; not required for Features 1, 3, or 4)
Inputs: product info, audience descriptions, requirements, CTA, aspect ratio, optional product image
Outputs: creative-proposals.json + ad-*.png images + reusable prompt templates
Connection to Feature 3: Upload generated images via lanbow-ads images upload, then reference image_hash in lanbow-ads creatives create.
Feature 3: Ad Delivery
Skill: lanbow-ads | Details: ad-delivery.md
Execute campaign setup and management via the lanbow-ads CLI.
Trigger phrases: "create campaign", "launch ads", "upload image", "show campaigns", "投放广告"
Requires: Meta Access Token, App ID, Ad Account ID (declared in requires.env). App Secret is optional — only needed for exchanging short-lived tokens to long-lived tokens via lanbow-ads auth exchange.
Credential setup (try in order):
- Environment variables or platform secret fields (best): If
META_ACCESS_TOKEN,META_APP_ID, andMETA_AD_ACCOUNT_IDare already set as environment variables (or via your platform's secret/credential fields), configure the CLI automatically:
lanbow-ads config set --app-id "$META_APP_ID"
lanbow-ads auth set-token "$META_ACCESS_TOKEN"
lanbow-ads config set --account "$META_AD_ACCOUNT_ID"
# Only if META_APP_SECRET is set (optional — needed only for token exchange):
[ -n "$META_APP_SECRET" ] && lanbow-ads config set --app-secret "$META_APP_SECRET"- Ask the user to provide credentials directly (most common): If env vars are not set, tell the user exactly how to get each credential from Meta's web interface. Recommend the user use their platform's secret fields or environment variables rather than pasting credentials directly into chat. If direct input is the only option, only request the minimum credentials needed for the current task:
- Access Token: Open https://developers.facebook.com/tools/explorer/ → select your App → click "Generate Access Token" → select permissions ads_management, ads_read, business_management → click "Submit" → copy the token - App ID: Go to https://developers.facebook.com/apps/ → select your App → App Settings → Basic - Ad Account ID: Go to https://adsmanager.facebook.com/ → find act_XXXXXXXXX in the URL or account dropdown - App Secret (only if needed for token exchange): App Settings → Basic → click "Show" next to App Secret
Then run the CLI commands on their behalf. For a full walkthrough, see meta-account-setup.md.
lanbow-ads auth login(last resort): This opens a browser on the agent's machine for OAuth. It only works when you and the user are on the same machine. Do NOT attempt this by default. If the user can't open the auth URL or auth login fails, fall back to method 2 immediately — ask for credentials directly. Do NOT retry or keep sending OAuth URLs.
Credential scope limits: The agent must ONLY use provided credentials for lanbow-ads CLI commands. The agent must NOT log, echo, or store credentials in any file other than via the lanbow-ads config set and lanbow-ads auth set-token commands. The agent must NOT transmit credentials to any endpoint other than the Meta Marketing API (via the CLI).
Campaign creation sequence:
lanbow-ads campaigns create— create campaign (PAUSED)lanbow-ads images upload/lanbow-ads videos upload— upload medialanbow-ads creatives create— create creative with medialanbow-ads adsets create— create ad set with targeting + budgetlanbow-ads ads create— create ad linking ad set + creative- Verify with
lanbow-ads campaigns get/lanbow-ads ads get
Key rules:
- Budgets in cents (5000 = $50.00)
- Always create in PAUSED status, activate after review
- Use
--jsonflag when output feeds into another step - For OUTCOME_SALES: must include
--promoted-objectwith pixel_id
Feature 4: Post-Campaign Review
Skill: post-campaign-review | Details: post-campaign-review.md
Analyze delivery data, diagnose performance issues, generate optimization recommendations.
Trigger phrases: "review campaign", "campaign diagnosis", "optimize ads", "复盘", "投后分析"
Data collection: Fetch via lanbow-ads insights get --json at multiple dimensions (campaign, ad set, ad, audience breakdowns, daily trends).
Diagnostic framework:
- Metric health check against benchmarks (CTR, CPC, CPM, frequency, ROAS)
- Root cause patterns: creative fatigue, audience saturation, targeting mismatch, budget issues, landing page problems
Output: Prioritized optimization plan (P0 immediate → P1 creative → P2 targeting → P3 strategic)
Feedback loop: Review findings feed back into:
- Feature 1 (new strategy if targeting mismatch or new opportunity found)
- Feature 2 (creative refresh if fatigue diagnosed)
- Feature 3 (budget/targeting adjustments, pause/activate ads)
Cross-Feature Data Flow
Strategy Report ──→ key message, key look, audiences ──→ Creative Gen
Creative Gen ──→ ad images, proposals ──→ Ad Delivery (upload + create)
Ad Delivery ──→ live campaign + performance data ──→ Post-Campaign Review
Review ──→ optimization actions ──→ Ad Delivery (adjust)
Review ──→ creative refresh needs ──→ Creative Gen (new round)
Review ──→ strategy refinement needs ──→ Strategy Research (re-analyze)Security & Privacy
Credentials
Required (declared in metadata.openclaw.requires.env — needed for ad delivery):
| Env Var | Sensitivity | Used By | Storage Location |
|---|---|---|---|
META_ACCESS_TOKEN | High — grants ad account access | Feature 3 (Ad Delivery) | lanbow-ads CLI config dir (~/.config/lanbow-ads/) |
META_APP_ID | Medium — app identifier | Feature 3 (Ad Delivery) | lanbow-ads CLI config dir |
META_AD_ACCOUNT_ID | Low — account identifier | Feature 3 (Ad Delivery) | lanbow-ads CLI config dir |
Optional (only request when the specific feature is needed):
| Env Var | Sensitivity | When Needed | Storage Location |
|---|---|---|---|
META_APP_SECRET | High — can generate long-lived tokens | Only for lanbow-ads auth exchange (short→long-lived token swap) | lanbow-ads CLI config dir |
GEMINI_API_KEY | High — API access | Only for Feature 2 (Creative Generation via Gemini) | User's environment only; never persisted by this skill |
Do NOT request optional credentials unless the user's task specifically requires them. For example, listing campaigns or checking insights needs only META_ACCESS_TOKEN, META_APP_ID, and META_AD_ACCOUNT_ID.
Secure Credential Delivery
Prefer environment variables or your platform's secret/credential fields over pasting credentials into chat. If the user must provide credentials in conversation, only request the minimum set needed for the current task. Never ask for META_APP_SECRET or GEMINI_API_KEY unless the user explicitly needs token exchange or creative generation.
Required Runtime Dependencies
| Dependency | Source | Purpose |
|---|---|---|
lanbow-ads CLI | Install via npm i -g lanbow-ads (npm registry) | Campaign management and performance data retrieval via Meta Marketing API |
| WebSearch / WebFetch | Built-in agent tools | Market research and competitive intelligence gathering |
Credential Scope Restrictions
The agent is restricted to the following credential operations only:
lanbow-ads config set --app-id/--app-secret/--account— configure CLIlanbow-ads auth set-token— set access tokenlanbow-ads auth exchange— exchange short-lived token for long-lived tokenlanbow-ads auth status— verify token validity
The agent must NOT:
- Log, echo, or print credentials in plain text
- Store credentials in any file other than via
lanbow-adsCLI commands - Transmit credentials to any endpoint other than the Meta Marketing API (via CLI)
- Use credentials for purposes outside ad campaign management
Data Flow & Privacy
- What leaves the machine: API calls to Meta Marketing API (via
lanbow-adsCLI), API calls to Google Gemini (for image generation), web searches (for strategy research) - What stays local: Strategy reports, generated creative images, campaign review documents, CLI configuration files
- Credential handling: Credentials are configured via the
lanbow-adsCLI and stored in its config directory (~/.config/lanbow-ads/). This skill itself does not persist or transmit credentials beyond passing them to the CLI.
Token Lifetime & Cleanup
| Token Type | Lifetime | When to Use |
|---|---|---|
| User Access Token (Graph API Explorer) | ~1-2 hours | Quick tests, one-off campaigns |
Long-lived User Token (via auth exchange) | ~60 days | Short-term automation |
| System User Token | Never expires | Production/agency use only |
After use, always clean up stored credentials:
lanbow-ads auth logout # Remove stored access token
lanbow-ads config unset --app-secret # Remove stored app secret
lanbow-ads config list # Verify no secrets remainSecurity Recommendations
- Use env vars or secret fields, not chat — provide credentials via environment variables or your platform's secret/credential input fields. Avoid pasting App Secret or long-lived tokens directly into an open conversation
- Only supply what's needed —
GEMINI_API_KEYis only needed for creative generation,META_APP_SECRETis only needed for token exchange. Do not provide them if your task doesn't require those features - Prefer short-lived tokens — start with a User Access Token from Graph API Explorer (~1-2 hours). Only use System User Tokens for production automation where you control the runtime
- Verify your runtime environment — only provide credentials if the agent runs on a machine you trust. Do NOT paste secrets into hosted/shared agent environments
- Use a dedicated test Ad Account — create a separate Ad Account with minimal budget for agent-managed campaigns; do not use your primary production account
- Least privilege scopes — when generating tokens, grant only
ads_managementandads_readunless additional permissions are explicitly needed - Rotate after use — revoke tokens in Meta Business Settings after your session ends, especially if you used long-lived tokens or App Secret
- Verify
lanbow-adsprovenance — install from the official npm registry and verify the package before use
Resources
All sub-skill instructions and reference materials are self-contained in references/.
Feature 1: Strategy Research
- strategy-research.md — Full strategy research system, research protocol, chapter-based output rules
- strategy-template.md — Report section structure (Executive Summary → Controls)
- strategy-meta-only-template.md — Meta-only campaign strategy template
- strategy-document-standards.md — Report formatting standards, table numbering, data source annotations
Feature 2: Creative Generation
- creative-generation.md — Full Gemini 2-step pipeline: proposals → image generation, API calls, prompt templates
Feature 3: Ad Delivery
- ad-delivery.md — Full lanbow-ads CLI guide: campaign creation, targeting, insights, configuration
- ad-delivery-commands.md — Complete command reference with all flags, types, and descriptions
- meta-account-setup.md — Step-by-step Meta developer registration, app creation, OAuth setup, and ad account configuration
Feature 4: Post-Campaign Review
- post-campaign-review.md — Full diagnostic framework, metric benchmarks, optimization plan template, feedback loop