Update marketing skills to v2.0.1

README.md

@@ -26,7 +26,7 @@
 - **@tag routing** in Telegram — `@researcher find AI trends` sends the message to the right agent
 - **Coordinator delegation** — one agent orchestrates the rest, delegating tasks automatically
 - **Shared memory** — agents read each other's output files for seamless collaboration
-- **130+ built-in skills** — SEO (19 skills + 30 reference files), ads (18 skills + 23 reference files), content, social media, analytics, growth hacking
+- **120+ built-in skills** — SEO (19 skills + 30 reference files), ads (18 skills + 23 reference files), content, social media, analytics, growth hacking
 - **25 built-in MCP servers** — browser automation, AI search, SEO, ads, social media, email marketing, CRM, disposable email inboxes, multimodal generation (image/video/speech/music), and more. Enable what you need from the Web UI
 - **52 marketing tools** via Citedy MCP server
 - **Instant file publishing** — upload any file to [here.now](https://here.now), get a shareable link, host static sites, use your own domain

docs/deploy/railway.md

@@ -6,7 +6,7 @@ This guide walks through deploying AdClaw — an AI marketing agent team — on
 
 ## What you get
 
-- **130+ built-in skills** — SEO, ads, content, social, audio, music, graphics, video, browser automation
+- **121 built-in skills** — SEO, ads, content, social, audio, music, graphics, video, browser automation
 - **Multi-agent personas** — Growth Hacker, Social Media Strategist, Content Writer, Analytics Reporter, plus your own. Coordinated by a central Coordinator. Address with `@persona-name` in chat; untagged messages route to the Coordinator.
 - **23 LLM providers** with 100+ models — OpenAI, Anthropic, Google Gemini, Aliyun (Qwen, GLM), Z.AI, xAI Grok, Mistral, DeepSeek, Groq, Together, OpenRouter, Cerebras, MiniMax, Baseten, Moonshot Kimi, Inception, ModelScope, DashScope, Ollama, llama.cpp, MLX, Azure OpenAI. Automatic failover between configured providers.
 - **Multi-channel chat** — Telegram, Discord, Feishu, DingTalk, QQ, or the built-in web console.
@@ -18,14 +18,12 @@ This guide walks through deploying AdClaw — an AI marketing agent team — on
 
 > ⚠️ **Plan: Hobby or higher (≥ 2 GB RAM, 25 GB disk).**
 >
-> AdClaw bundles a Python agent runtime + skill registry + Chromium, so
-> Railway's Free plan is not enough. Use **Hobby or higher**. Hobby is
-> **$5/month** and includes **$5 of monthly usage credits**.
+> AdClaw bundles a Python agent runtime + skill registry + Chromium that need ≥ 600 MB on startup. The 30-day Trial 512 MB instance OOMs immediately. Hobby is **$5/month + usage**; idle AdClaw consumes about $0.50–$1/day so the included credits cover ~5 days of testing.
 
 | Plan | Works? | Notes |
 |---|---|---|
-| Free / 0.5 GB RAM | ❌ | Not enough RAM/volume for AdClaw |
-| Hobby ($5/mo) | ✅ | Recommended starter |
+| Trial / 512 MB | ❌ | OOM at startup |
+| Hobby ($5/mo, 2 GB) | ✅ | Recommended starter |
 | Pro and higher | ✅ | For multiple personas under load |
 
 You'll also need:
@@ -49,7 +47,7 @@ You do **not** need a Citedy account to use AdClaw — Citedy MCP is opt-in.
 
 If you prefer to wire it up yourself:
 
-1. **New Project → Deploy from GitHub repo** → `Citedy/adclaw`. Or **Deploy from Docker Image** → `nttylock/adclaw:1.0.7`.
+1. **New Project → Deploy from GitHub repo** → `Citedy/adclaw`. Or **Deploy from Docker Image** → `nttylock/adclaw:1.0.26`.
 2. **Settings → Networking** → expose port `8088`, generate the public domain.
 3. **Settings → Build** → confirm builder is **Dockerfile** with path `deploy/Dockerfile` (read from `railway.json` automatically).
 4. **Settings → Deploy**:
@@ -88,15 +86,11 @@ If you only attach one, pick `/app/working` and accept that LLM keys live inside
 
 | Tag | Image size | Idle RAM | Best for |
 |---|---|---|---|
-| `nttylock/adclaw:1.0.7` (default pin) | ~4.2 GB | 600–800 MB | Full feature set — Chromium for browser/scraping/social skills |
-| `nttylock/adclaw:1.0.7-browser` | ~4.1 GB | similar | Browser-only, no Feishu/DingTalk channels |
-| `nttylock/adclaw:1.0.7-core` | ~2.7 GB | 250–400 MB | Lightweight — no Chromium, no desktop tools |
+| `nttylock/adclaw:1.0.26` (default pin) | ~4.2 GB | 600–800 MB | Full feature set — Chromium for browser/scraping/social skills |
+| `nttylock/adclaw:1.0.26-browser` | ~4.1 GB | similar | Browser-only, no Feishu/DingTalk channels |
+| `nttylock/adclaw:1.0.26-core` | ~2.7 GB | 250–400 MB | Lightweight — no Chromium, no desktop tools |
 
-Switch by editing **Settings → Source** to use a Docker Image source instead of GitHub repo, then set the image to `nttylock/adclaw:1.0.7-core`. Build is skipped — deploy is ~30 s.
-
-If you need a reproducible release pin instead of the moving variant tags, use
-the versioned aliases published by the release workflow, for example
-`nttylock/adclaw:1.0.7-core` or `nttylock/adclaw:1.0.7-browser`.
+Switch by editing **Settings → Source** to use a Docker Image source instead of GitHub repo, then set the image to `nttylock/adclaw:1.0.26-core`. Build is skipped — deploy is ~30 s.
 
 ## Post-deploy workflow
 
@@ -123,20 +117,11 @@ curl https://<your-railway-url>/api/diagnostics/health
 
 Returns the status of LLM, channels, memory, AOM, MCP, and watchdog. Safe to poll from external monitors.
 
-## Pricing note
-
-Railway Hobby currently costs **$5/month** and includes **$5 of monthly usage
-credits**.
-
-For AdClaw, the important practical rule is:
-
-- **Free** is not enough for deployment
-- **Hobby** is the minimum supported Railway plan
-- if your usage goes beyond the included monthly credit, Railway charges the
-  overage
+## Cost estimate
 
-Set [Railway Spending Limits](https://docs.railway.com/reference/usage-limits)
-if you want a hard cap.
+Idle (no traffic, default config): about **$0.50–$1/day** on Hobby.
+Active use (continuous chat, browser skills, frequent cron): up to **$3–5/day**.
+Hobby includes $5/month — covers light usage. Set [Railway Spending Limits](https://docs.railway.com/reference/usage-limits) to cap.
 
 ## Troubleshooting
 
@@ -158,6 +143,7 @@ if you want a hard cap.
 ## Source code & support
 
 - **Public repo:** https://github.com/Citedy/adclaw
+- **Source of truth:** https://github.com/nttylock/AdClaw (private dev — public mirror sync on every release)
 - **DigitalOcean Marketplace:** https://marketplace.digitalocean.com/apps/adclaw
 - **Issues:** https://github.com/Citedy/adclaw/issues
 - **License:** Apache-2.0

docs/getting-started.md

@@ -1,6 +1,6 @@
 # Getting Started with AdClaw
 
-AdClaw is an AI marketing assistant powered by [Citedy](https://www.citedy.com). It comes with 130+ built-in skills (SEO, ads, content, social media, analytics, and more), 52 MCP tools, and works out of the box via Telegram or web chat.
+AdClaw is an AI marketing assistant powered by [Citedy](https://www.citedy.com). It comes with 121 built-in skills (SEO, ads, content, social media, analytics, and more), 52 MCP tools, and works out of the box via Telegram or web chat.
 
 ## Quick Install
 
@@ -27,15 +27,14 @@ docker run -d --name adclaw \
   -v adclaw-data:/app/working \
   -e CITEDY_API_KEY=your_citedy_agent_key \
   -e TELEGRAM_BOT_TOKEN=your_telegram_bot_token \
-  nttylock/adclaw:1.0.7
+  nttylock/adclaw:1.0.26
 ```
 
 The release workflow publishes images for both `linux/amd64` and
 `linux/arm64`. If you are testing local source changes before the next
 Docker release, use Docker Compose from this repo so the image is built on
-your machine. If you need a pinned published tag instead of the moving
-`latest`, use `nttylock/adclaw:1.0.7`, `nttylock/adclaw:1.0.7-browser`, or
-`nttylock/adclaw:1.0.7-core`.
+your machine. If you prefer the moving full-variant alias after the release is
+live, `nttylock/adclaw:latest` continues to track the current full line.
 
 ## First-Run Setup
 

docs/marketing-skills-v2.0.1-audit.md

@@ -0,0 +1,74 @@
+# Marketing Skills v2.0.1 Audit
+
+Date: 2026-05-26
+
+Source package: `coreyhaines31/marketingskills`
+
+Installer result: `npx skills add coreyhaines31/marketingskills -y` found 41 skills.
+
+## Result
+
+- Upgraded 31 existing AdClaw built-in marketing skills by syncing v2.0.1 content into the existing `marketing-*` skill directories.
+- Added 10 new AdClaw built-in marketing skills using the existing `marketing-*` naming convention.
+- Left existing Citedy, SEO, ads, agency, and platform skills in place.
+- Private AdClaw static skill security scan passed for all 41 v2.0.1 source skills with zero missing skills, blocked findings, or warnings.
+- Targeted private validator regression tests passed: `90 passed, 1 skipped`.
+- Live LLM audit was attempted through `tests/test_skill_validator_real.py`, but the test file skipped because no `QWEN_API_KEY`, `GLM_API_KEY`, or `OPENAI_API_KEY` was available in `/root/.env` or the private checkout.
+
+## Upgraded Existing Skills
+
+| v2.0.1 source | AdClaw built-in skill |
+| --- | --- |
+| `ab-testing` | `marketing-ab-test-setup` |
+| `ad-creative` | `marketing-ad-creative` |
+| `ads` | `marketing-paid-ads` |
+| `ai-seo` | `marketing-ai-seo` |
+| `analytics` | `marketing-analytics-tracking` |
+| `churn-prevention` | `marketing-churn-prevention` |
+| `cold-email` | `marketing-cold-email` |
+| `competitors` | `marketing-competitor-alternatives` |
+| `content-strategy` | `marketing-content-strategy` |
+| `copy-editing` | `marketing-copy-editing` |
+| `copywriting` | `marketing-copywriting` |
+| `cro` | `marketing-page-cro` |
+| `emails` | `marketing-email-sequence` |
+| `free-tools` | `marketing-free-tool-strategy` |
+| `launch` | `marketing-launch-strategy` |
+| `marketing-ideas` | `marketing-marketing-ideas` |
+| `marketing-psychology` | `marketing-psychology` |
+| `onboarding` | `marketing-onboarding-cro` |
+| `paywalls` | `marketing-paywall-upgrade-cro` |
+| `popups` | `marketing-popup-cro` |
+| `pricing` | `marketing-pricing-strategy` |
+| `product-marketing` | `marketing-product-marketing-context` |
+| `programmatic-seo` | `marketing-programmatic-seo` |
+| `referrals` | `marketing-referral-program` |
+| `revops` | `marketing-revops` |
+| `sales-enablement` | `marketing-sales-enablement` |
+| `schema` | `marketing-schema-markup` |
+| `seo-audit` | `marketing-seo-audit` |
+| `signup` | `marketing-signup-flow-cro` |
+| `site-architecture` | `marketing-site-architecture` |
+| `social` | `marketing-social-content` |
+
+## Added New Skills
+
+| v2.0.1 source | New AdClaw built-in skill |
+| --- | --- |
+| `aso` | `marketing-aso` |
+| `co-marketing` | `marketing-co-marketing` |
+| `community-marketing` | `marketing-community-marketing` |
+| `competitor-profiling` | `marketing-competitor-profiling` |
+| `customer-research` | `marketing-customer-research` |
+| `directory-submissions` | `marketing-directory-submissions` |
+| `image` | `marketing-image` |
+| `lead-magnets` | `marketing-lead-magnets` |
+| `sms` | `marketing-sms` |
+| `video` | `marketing-video` |
+
+## Notable v2.0.1 Additions Verified
+
+- `marketing-image` includes the May 2026 image model lineup: Gemini Nano Banana Pro, Flux, Ideogram 3.0, ChatGPT Images 2.0 / GPT Image, Midjourney v7, Recraft V3, and Stable Diffusion.
+- `marketing-video` includes the May 2026 video model lineup: Veo 3, Sora 2, Runway Gen-4, Kling 2.5/3.0, Seedance, Hailuo / MiniMax, Pika 2.x, Hunyuan Video, and Wan 2.
+- `marketing-ad-creative` includes ChatGPT Images 2.0 in its generative tools reference.
+- Community PR coverage is present through the new skills and references for community marketing, competitor profiling, directory submissions, AI SEO, and research workflows.

docs/skills.md

@@ -1,14 +1,14 @@
 # Skills Library
 
-AdClaw ships with **113 built-in skills** across 10 categories. All skills are security-scanned (208-pattern static analysis + LLM audit).
+AdClaw ships with **121 built-in skills** across 10 categories. All skills are security-scanned (208-pattern static analysis + LLM audit).
 
 ---
 
 ## Categories
 
 | Category | Count | Description |
 |----------|-------|-------------|
-| Marketing | 33 | CRO, copywriting, email, psychology, pricing, referral, launch |
+| Marketing | 43 | CRO, copywriting, email, psychology, pricing, referral, launch, media, SMS, community |
 | SEO | 19 | Audits, backlinks, technical, local, schema, programmatic, images |
 | Ads | 18 | Google, Meta, LinkedIn, TikTok, YouTube, Apple, Microsoft, creative |
 | Citedy | 6 | SEO autopilot, content writer, video shorts, trends, leads, ingestion |
@@ -17,7 +17,7 @@ AdClaw ships with **113 built-in skills** across 10 categories. All skills are s
 | Agency | 5 | Growth hacker, analytics reporter, app store optimizer, feedback synthesizer, trend researcher |
 | Office | 4 | PDF, DOCX, PPTX, XLSX |
 | Utility | 10 | Email, file reader, here.now publish, himalaya, cron, news, self-setup, skill-creator, GA4, GSC |
-| Platform | 7 | AgentHub worker, DingTalk channel, Google Ads API, browser_visible, marketing-mode, ads-shared, seo-shared |
+| Platform | 5 | AgentHub worker, DingTalk channel, Google Ads API, browser_visible, marketing-mode |
 
 ---
 
@@ -68,7 +68,7 @@ AdClaw ships with **113 built-in skills** across 10 categories. All skills are s
 | `ads-tiktok` | TikTok Ads analysis (creative, tracking, bidding) |
 | `ads-youtube` | YouTube Ads analysis (campaign types, creative, audience) |
 
-## Marketing Skills (33)
+## Marketing Skills (43)
 
 | Skill | Description |
 |-------|-------------|
@@ -77,18 +77,26 @@ AdClaw ships with **113 built-in skills** across 10 categories. All skills are s
 | `marketing-ad-creative` | Ad creative generation and iteration at scale |
 | `marketing-ai-seo` | Optimize for AI search engines (ChatGPT, Gemini, Perplexity) |
 | `marketing-analytics-tracking` | Analytics setup, event tracking, measurement |
+| `marketing-aso` | App Store and Google Play listing optimization |
 | `marketing-churn-prevention` | Reduce churn, cancellation flows, save offers |
+| `marketing-co-marketing` | Co-marketing partners and joint campaign planning |
 | `marketing-cold-email` | B2B cold email and follow-up sequences |
+| `marketing-community-marketing` | Community strategy, advocates, and community-led growth |
 | `marketing-competitor-alternatives` | Competitor comparison and alternative pages |
+| `marketing-competitor-profiling` | Competitor research and structured competitor profiles |
 | `marketing-content-strategy` | Content strategy planning and editorial calendar |
 | `marketing-copy-editing` | Edit and improve existing marketing copy |
 | `marketing-copywriting` | Write marketing copy for any page type |
+| `marketing-customer-research` | Customer research, ICP, VOC, and review mining |
+| `marketing-directory-submissions` | Directory submissions for launch discovery and backlinks |
 | `marketing-email-sequence` | Email sequences, drip campaigns, automated flows |
 | `marketing-form-cro` | Form optimization (lead capture, surveys, checkout) |
 | `marketing-free-tool-strategy` | Free tool planning for lead generation |
+| `marketing-image` | Marketing image generation, editing, and optimization |
 | `marketing-launch-strategy` | Product launch and feature announcement planning |
+| `marketing-lead-magnets` | Lead magnet strategy for gated content and downloads |
 | `marketing-marketing-ideas` | Marketing idea generation and brainstorming |
-| `marketing-marketing-psychology` | Apply behavioral science to marketing |
+| `marketing-psychology` | Apply behavioral science to marketing |
 | `marketing-onboarding-cro` | Post-signup onboarding and activation optimization |
 | `marketing-page-cro` | Landing page conversion rate optimization |
 | `marketing-paid-ads` | Paid advertising campaign help (Google, Meta, LinkedIn) |
@@ -104,7 +112,9 @@ AdClaw ships with **113 built-in skills** across 10 categories. All skills are s
 | `marketing-seo-audit` | SEO audit and diagnostics |
 | `marketing-signup-flow-cro` | Signup and registration flow optimization |
 | `marketing-site-architecture` | Site hierarchy, navigation, URL structure |
+| `marketing-sms` | SMS and MMS marketing flows and compliance |
 | `marketing-social-content` | Social media content creation and scheduling |
+| `marketing-video` | AI video generation and programmatic video workflows |
 
 ## Citedy Skills (6)
 

pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "adclaw"
 dynamic = ["version"]
-description = "Multi-agent AI marketing team with 117 skills, multi-channel support, and shared memory"
+description = "Multi-agent AI marketing team with 121 skills, multi-channel support, and shared memory"
 readme = "README.md"
 requires-python = ">=3.10,<3.14"
 license = {text = "Apache-2.0"}