fix: clean up aso-audit skill for cross-agent compatibility

- Replace Playwright-specific tool references with generic instructions
- Convert description from YAML multiline to quoted string (repo convention)
- Add Task-Specific Questions section
- Add Related Skills section

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
   "plugins": [
     {
       "name": "marketing-skills",
-      "description": "36 marketing skills for technical marketers and founders: ASO, CRO, copywriting, cold email, SEO, AI SEO, paid ads, ad creative, churn prevention, pricing strategy, referral programs, revenue operations, sales enablement, customer research, site architecture, and more",
+      "description": "34 marketing skills for technical marketers and founders: ASO, CRO, copywriting, cold email, SEO, AI SEO, paid ads, ad creative, churn prevention, pricing strategy, referral programs, revenue operations, sales enablement, customer research, site architecture, and more",
       "source": "./",
       "strict": false,
       "skills": [
@@ -23,7 +23,6 @@
         "./skills/analytics-tracking",
         "./skills/churn-prevention",
         "./skills/cold-email",
-        "./skills/community-marketing",
         "./skills/competitor-alternatives",
         "./skills/content-strategy",
         "./skills/copy-editing",

README.md

@@ -54,18 +54,17 @@ See each skill's **Related Skills** section for the full dependency map.
 <!-- SKILLS:START -->
 | Skill | Description |
 |-------|-------------|
-| [ab-test-setup](skills/ab-test-setup/) | When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program.... |
+| [ab-test-setup](skills/ab-test-setup/) | When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B... |
 | [ad-creative](skills/ad-creative/) | When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad... |
 | [ai-seo](skills/ai-seo/) | When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers.... |
 | [analytics-tracking](skills/analytics-tracking/) | When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions... |
 | [churn-prevention](skills/churn-prevention/) | When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or... |
 | [cold-email](skills/cold-email/) | Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails,... |
-| [community-marketing](skills/community-marketing/) | Build and leverage online communities to drive product growth and brand loyalty. Use when the user wants to create a... |
 | [competitor-alternatives](skills/competitor-alternatives/) | When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when... |
 | [content-strategy](skills/content-strategy/) | When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also... |
-| [copy-editing](skills/copy-editing/) | When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the... |
+| [copy-editing](skills/copy-editing/) | When the user wants to edit, review, or improve existing marketing copy. Also use when the user mentions 'edit this... |
 | [copywriting](skills/copywriting/) | When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages,... |
-| [customer-research](skills/customer-research/) | When the user wants to conduct, analyze, or synthesize customer research. Use when the user mentions "customer... |
+| [customer-research](skills/customer-research/) | When the user wants to conduct, analyze, or synthesize customer research — including interview transcripts, surveys, support tickets, review mining, Reddit/G2/forum research, persona generation, and voice of customer (VOC)... |
 | [email-sequence](skills/email-sequence/) | When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email... |
 | [form-cro](skills/form-cro/) | When the user wants to optimize any form that is NOT signup/registration — including lead capture forms, contact forms,... |
 | [free-tool-strategy](skills/free-tool-strategy/) | When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or... |

skills/community-marketing/SKILL.md

@@ -141,23 +141,3 @@ Depending on what the user needs, produce one of:
 - **Health Audit Report** — Current metrics, diagnosis, top 3 priorities to fix
 
 Always be specific. Generic advice ("be consistent," "provide value") is not useful. Give the user something they can act on today.
-
----
-
-## Task-Specific Questions
-
-1. What platform are you building on (or considering)?
-2. What stage is the community at? (Pre-launch, early, growing, established)
-3. What's the primary business goal? (Retention, activation, word-of-mouth, support deflection)
-4. Who is the ideal community member and what motivates them?
-5. Do you have existing users or customers to seed from?
-6. How much time can you dedicate to community management weekly?
-
----
-
-## Related Skills
-
-- **referral-program**: For structured referral and ambassador incentive programs
-- **churn-prevention**: For retention strategies that complement community engagement
-- **social-content**: For content creation across social platforms
-- **customer-research**: For understanding your community members' needs and language

skills/social-content/SKILL.md

@@ -49,7 +49,6 @@ Gather this context (ask if not provided):
 | Facebook | Communities, local businesses | 1-2x/day | Groups, native video |
 
 **For detailed platform strategies**: See [references/platforms.md](references/platforms.md)
-
 **For hashtag limits and character counts**: See [references/platform-limits.md](references/platform-limits.md)
 
 ---

tools/REGISTRY.md

@@ -61,7 +61,7 @@ Quick reference for AI agents to discover tool capabilities and integration meth
 | meta-ads | Ads | ✓ | - | [✓](clis/meta-ads.js) | ✓ | [meta-ads.md](integrations/meta-ads.md) |
 | linkedin-ads | Ads | ✓ | - | [✓](clis/linkedin-ads.js) | - | [linkedin-ads.md](integrations/linkedin-ads.md) |
 | tiktok-ads | Ads | ✓ | - | [✓](clis/tiktok-ads.js) | ✓ | [tiktok-ads.md](integrations/tiktok-ads.md) |
-| zapier | Automation | ✓ | ✓ | [✓](clis/zapier.js) | ✓ | [zapier.md](integrations/zapier.md) |
+| zapier | Automation | ✓ | ✓ | [✓](clis/zapier.js) | - | [zapier.md](integrations/zapier.md) |
 | hotjar | CRO | ✓ | - | [✓](clis/hotjar.js) | - | [hotjar.md](integrations/hotjar.md) |
 | optimizely | A/B Testing | ✓ | - | [✓](clis/optimizely.js) | ✓ | [optimizely.md](integrations/optimizely.md) |
 | calendly | Scheduling | ✓ | - | [✓](clis/calendly.js) | - | [calendly.md](integrations/calendly.md) |
@@ -202,9 +202,9 @@ Workflow automation and integration platforms.
 
 | Tool | Best For | MCP Available |
 |------|----------|:-------------:|
-| **zapier** | No-code integrations + SDK for 8,000+ apps | ✓ |
+| **zapier** | No-code integrations | ✓ |
 
-**Agent recommendation**: Zapier SDK for agents that need to interact with any app directly. Zaps for always-on automations.
+**Agent recommendation**: Zapier for connecting tools without code.
 
 ### CRO & A/B Testing
 
@@ -456,7 +456,7 @@ These tools have Model Context Protocol servers available, enabling direct agent
 - **mailchimp** - Email campaign management
 - **google-ads** - Ad campaign management
 - **resend** - Transactional email sending
-- **zapier** - Workflow automation + SDK for 8,000+ app integrations
+- **zapier** - Workflow automation
 - **zoominfo** - B2B contacts and intent data
 - **clay** - Data enrichment and outbound automation
 - **supermetrics** - Cross-platform marketing data

tools/integrations/zapier.md

@@ -1,6 +1,6 @@
 # Zapier
 
-Workflow automation platform connecting 8,000+ apps. The Zapier SDK gives AI agents direct access to any app's actions without building OAuth flows or reverse-engineering APIs.
+Workflow automation platform connecting apps without code.
 
 ## Capabilities
 
@@ -8,110 +8,16 @@ Workflow automation platform connecting 8,000+ apps. The Zapier SDK gives AI age
 |-------------|-----------|-------|
 | API | ✓ | REST API for Zaps, tasks, and webhooks |
 | MCP | ✓ | Available via Zapier MCP server |
-| CLI | ✓ | `@zapier/zapier-sdk-cli` for app discovery and type generation |
+| CLI | - | Not available |
-| SDK | ✓ | `@zapier/zapier-sdk` — TypeScript SDK for 8,000+ app integrations |
+| SDK | - | API and webhooks only |
 
 ## Authentication
 
-### Legacy API (Zaps management)
-
 - **Type**: API Key
 - **Header**: `X-API-Key: {api_key}`
 - **Get key**: Settings > API in Zapier account
 
-### SDK Authentication
+## Common Agent Operations
-
-**Browser-based login (development):**
-```bash
-npx zapier-sdk login
-```
-
-**Server-side (production):**
-- Client Credentials — store as environment variables
-- Direct token — set `ZAPIER_CREDENTIALS` env var
-
-Browser-based login only works locally. Use Client Credentials for any server-side deployment.
-
-## SDK Quick Start
-
-### Install
-
-```bash
-npm install @zapier/zapier-sdk
-npm install -D @zapier/zapier-sdk-cli @types/node typescript
-npm pkg set type=module
-```
-
-### Initialize
-
-```typescript
-import { createZapierSdk } from "@zapier/zapier-sdk";
-const zapier = createZapierSdk();
-```
-
-### CLI Commands
-
-| Command | Purpose |
-|---------|---------|
-| `npx zapier-sdk login` | Authenticate (dev only) |
-| `npx zapier-sdk list-apps --search "query"` | Search available apps |
-| `npx zapier-sdk list-actions APP_KEY` | List actions for an app |
-| `npx zapier-sdk add [app-key]` | Generate TypeScript types |
-
-### SDK Methods
-
-| Method | Purpose |
-|--------|---------|
-| `zapier.listConnections()` | List authenticated app connections |
-| `zapier.findFirstConnection()` | Find a specific connection |
-| `zapier.runAction()` | Execute an action on a connected app |
-| `zapier.apps.slack()` | App proxy pattern for clean syntax |
-| `zapier.fetch()` | Custom authenticated API calls |
-
-### Example: Send a Slack Message
-
-```typescript
-import { createZapierSdk } from "@zapier/zapier-sdk";
-
-const zapier = createZapierSdk();
-const slack = await zapier.apps.slack();
-
-await slack.sendChannelMessage({
-  channel: "#marketing",
-  message: "Campaign launched!"
-});
-```
-
-### Example: Create a HubSpot Contact
-
-```typescript
-const hubspot = await zapier.apps.hubspot();
-
-await hubspot.createContact({
-  email: "lead@example.com",
-  firstName: "Jane",
-  lastName: "Doe"
-});
-```
-
-### Pagination
-
-Use `.items()` for large datasets:
-
-```typescript
-const contacts = await hubspot.listContacts({ maxItems: 100 });
-for await (const contact of contacts.items()) {
-  console.log(contact.email);
-}
-```
-
-### Governance Note
-
-Direct API calls via `zapier.fetch()` are not subject to org app/action restriction policies. Use pre-built actions where possible if your org has governance requirements.
-
----
-
-## Zaps API (Legacy)
 
 ### List Zaps
 
@@ -176,29 +82,30 @@ POST https://hooks.zapier.com/hooks/catch/{account_id}/{hook_id}/
 
 ## Common Marketing Automations
 
-### With SDK (recommended for agents)
+### Lead capture to CRM
-
+```
-```typescript
+Typeform → Zapier → HubSpot
-// Lead capture to CRM
-const hubspot = await zapier.apps.hubspot();
-await hubspot.createContact({ email, firstName, lastName });
-
-// New customer notification
-const slack = await zapier.apps.slack();
-await slack.sendChannelMessage({ channel: "#revenue", message: `New customer: ${email}` });
-
-// Add to email sequence
-const customerio = await zapier.apps.customerio();
-await customerio.createOrUpdatePerson({ email, plan: "pro" });
 ```
 
-### With Zaps (no-code)
+### New customer notifications
+```
+Stripe (new customer) → Zapier → Slack
+```
 
-- Typeform → Zapier → HubSpot (lead capture)
+### Email sequence triggers
-- Stripe → Zapier → Slack (new customer alerts)
+```
-- Form submission → Zapier → Customer.io (email sequences)
+Form submission → Zapier → Customer.io
-- New review → Zapier → Slack (social proof)
+```
-- New referral → Zapier → Spreadsheet + Slack (referral tracking)
+
+### Social proof automation
+```
+New review → Zapier → Twitter/Slack
+```
+
+### Referral tracking
+```
+New referral → Zapier → Spreadsheet + Slack
+```
 
 ## Webhook Payload Structure
 
@@ -216,24 +123,24 @@ When sending to Zapier, structure data as flat JSON:
 
 ## Key Concepts
 
-- **Zap** - Automated workflow (no-code)
+- **Zap** - Automated workflow
-- **SDK** - Programmatic access to 8,000+ app integrations
 - **Trigger** - Event that starts a Zap
-- **Action** - Task performed by Zap or SDK
+- **Action** - Task performed by Zap
 - **Task** - Single action execution
-- **Connection** - Authenticated link to an app (shared between Zaps and SDK)
+- **Filter** - Conditional logic
+- **Path** - Branching logic
 
 ## When to Use
 
-- **SDK**: When an AI agent needs to interact with any app directly — send messages, create records, sync data
+- Connecting marketing tools without code
-- **Zaps**: When you need always-on automation without code
+- Automating lead routing
-- **Webhooks**: When triggering workflows from your own app
+- Syncing data between platforms
-- **API**: When managing Zaps programmatically
+- Triggering notifications
+- Building marketing workflows
 
 ## Rate Limits
 
-- API: 100 requests per minute
+- 100 requests per minute
-- SDK: Rate limits per connected app
 - Task limits by plan tier
 
 ## Relevant Skills
@@ -241,4 +148,3 @@ When sending to Zapier, structure data as flat JSON:
 - email-sequence
 - analytics-tracking
 - referral-program
-- revops