lead-quality-recommendation-prioritization
Skill72 starsChanged 4 months agoMITView on GitHub
Recommendation prioritization framework with implementation timelines for lead quality investigations. Auto-invoke when generating recommendations, prioritizing actions, or creating implementation plans. Provides 3-tier priority system (Immediate/Medium/Long-term) with structured recommendation templates.
In this repository41 other files it gives its agents.
- account-diagnosticSkill
- ad-copy-generation-frameworkSkill
- ad-copy-verification-standardSkill
- add-account-negative-keywordsSkill
- ads-checkerSkill
- budget-guardianSkill
- budget-recommendation-calculatorSkill
- change-history-checkerSkill
- client-communication-standardsSkill
- competitor-analysis-v2Skill
- conversion-tracking-healthSkill
- dgen-automation-disableSkill
- fair-housing-complianceSkill
- ga4-campaign-cross-referenceSkill
- ga4-cross-analysisSkill
- ga4-lead-quality-investigationSkill
- gaql-query-patternsSkill
- geo-conflict-analyzerSkill
- google-ads-api-setupSkill
- google-ads-querySkill
- google-ads-samplesSkill
- impression-share-diagnosticsSkill
- investigation-methodologySkill
- lead-quality-pattern-analysisSkill
- markdown-to-sheets-presenterSkill
- mcc-hack-auditSkill
- mutation-safetySkill
- neg-conflict-finderSkill
- non-serving-keyword-scannerSkill
- pmax-asset-automationSkill
- pmax-builderSkill
- portfolio-health-prioritizationSkill
- portfolio-pacing-rulesSkill
- rsa-bulk-editSkill
- rsa-refreshSkill
- rsa-single-accountSkill
- shared-budget-updaterSkill
- sqr-classifierSkill
- sqr-pipelineSkill
- underspending-investigationSkill
- youtube-placement-auditSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 8 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈8
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 50
No approvals or testing required
- Distinctive: line 265
Purpose: Document what was checked but didn't pan out, preventing redundant recommendations in future analyses.
- Distinctive: line 382
Use this tree to determine priority tier for each recommendation:
- Distinctive: line 410
Before adding any recommendation to final report:
- Distinctive: line 422
Do NOT include recommendation
- Distinctive: line 436
Create "What Was Ruled Out" documentation
- Very specific: line 456
Add /blog/* URL exclusions → Addresses 76.2% blog traffic
- Distinctive: line 470
Add negative keywords → Already comprehensive list configured
- Distinctive: line 473
Week 1: All IMMEDIATE actions completed
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Lead Quality Recommendation Prioritization Skill
Purpose: Provides standardized methodology for prioritizing and structuring lead quality recommendations with clear implementation timelines and success metrics.
Type: Domain knowledge skill (auto-invoked)
What This Skill Deliberately Does NOT Do
- Detect the issues. Its inputs are red flags from
lead-quality-pattern-analysisand verified gaps fromga4-campaign-cross-reference; it prioritizes, it doesn't find. - Recommend the unverified. Its Core Principle is Verified-first — an unconfirmed hypothesis is documented in "What Was Ruled Out," never shipped as an action.
- Execute the changes. It structures the plan and timeline; applying the changes is downstream and mutation-gated.
- Format the client deliverable. The final report formatting is
client-communication-standards.
Core Principle: Actionable, Verified, Prioritized
Every recommendation must be:
- Verified - Confirmed as not already implemented
- Specific - Exact steps, not generic advice
- Prioritized - Clear timeline (Immediate/Medium/Long-term)
- Measurable - Expected impact quantified when possible
Anti-Pattern to Avoid:
- ❌ "Improve targeting" (too vague)
- ❌ "Add negative keywords" (already done? which keywords?)
- ❌ "Optimize campaign" (no specific action)
Correct Pattern:
- ✅ "Add
/blog/*to URL exclusions (not currently configured) - Expected to reduce conversions from blog pages by ~75%"
Three-Tier Priority System
🚨 Tier 1: IMMEDIATE ACTIONS (Implement Today)
Criteria for Immediate Priority:
- Quick wins (can be done in <1 hour)
- Critical fixes (>3 red flags, severe quality issues)
- High impact, low effort
- No approvals or testing required
- Directly addresses root cause
Time Frame: Today (same day)
Examples:
- Adding URL exclusions for blog content
- Excluding mobile app placements
- Pausing underperforming campaigns
- Adding negative keywords for irrelevant queries
⚠️ Tier 2: MEDIUM-TERM ACTIONS (This Week)
Criteria for Medium Priority:
- Requires testing or validation
- Needs approval from client or stakeholder
- Medium effort (2-4 hours implementation)
- Strategic changes (bidding strategy, audience signals)
- Requires monitoring period before next step
Time Frame: Within 7 days
Examples:
- Adding conversion value rules
- Implementing audience signals
- Creating new campaigns or ad groups
- Adjusting budgets based on quality performance
- Setting up ad scheduling restrictions
ℹ️ Tier 3: LONG-TERM STRATEGIES (This Month)
Criteria for Long-term Priority:
- Strategic initiatives (requires planning)
- Requires development work (landing pages, tracking)
- Needs multiple stakeholder approvals
- High effort (>1 week implementation)
- Foundational changes to account structure
Time Frame: Within 30 days
Examples:
- Implementing offline conversion tracking
- Creating dedicated thank-you pages with quality differentiation
- Building new landing pages
- Restructuring campaign architecture
- Implementing CRM integrations
Recommendation Structure Template
Standard Recommendation Format
#### {Priority Emoji} {Action Number}. {Action Name}
**Current State:** {What exists now - be specific}
**Recommendation:** {Specific change to implement}
**Implementation Steps:**
1. {Step 1 - exact instruction}
2. {Step 2 - exact instruction}
3. {Step 3 - exact instruction}
**Expected Impact:**
- {Quantified metric if possible}
- {Timeline for seeing results}
**Verification Before Implementing:**
- [ ] Not already configured (checked {date})
- [ ] Technically feasible (confirmed {method})
- [ ] No conflicts with other campaignsRecommendation Examples by Tier
Example 1: IMMEDIATE - URL Exclusions
#### 🚨 1. Exclude Blog/Community Content from Performance Max
**Current State:**
- No URL exclusions configured
- 76.2% of conversions (64 of 84) coming from `/blog/*` blog pages
- Blog content = moving tips, neighborhood guides (informational, not property-focused)
**Recommendation:**
Add content exclusions for blog/informational URLs to focus spend on property/conversion pages
**Implementation Steps:**
1. Navigate to Performance Max campaign settings
2. Go to "Content" → "Exclusions" → "Excluded content"
3. Add the following URL patterns:
- `*acme-plumbing.com/blog/*`
- `*acme-plumbing.com/news/*`
4. Save changes
**Expected Impact:**
- Reduce conversions from blog traffic by ~75% (64 → 16 conversions)
- Improve lead quality by focusing on users viewing service pages
- May see 20-30% decrease in total conversions, but 50%+ improvement in show-up rate
- Should see impact within 3-5 days
**Verification:**
- ✅ Confirmed no URL exclusions currently configured (checked 2025-10-24)
- ✅ Blog URLs account for majority of low-quality conversions
- ✅ No risk to service page conversions (separate URL structure)Example 2: MEDIUM - Conversion Value Rules
#### ⚠️ 2. Implement Conversion Value Rules Based on User Engagement
**Current State:**
- All conversions assigned equal value ($1 default)
- Bidding strategy = Maximize Conversion Value
- GA4 shows wide variance in user engagement (some <10 sec, some >5 min sessions)
- Algorithm can't differentiate high-engagement vs low-engagement conversions
**Recommendation:**
Create conversion value rules that assign higher value to engaged users
**Implementation Steps:**
1. Go to Tools → Conversions → Select "contact_form_submission"
2. Click "Value rules" → "New rule"
3. Create rules based on conditions:
- **Rule 1 (High Value):** IF session duration >120 sec AND pages/session >3 → Value = $5
- **Rule 2 (Medium Value):** IF session duration 30-120 sec → Value = $3
- **Rule 3 (Low Value):** IF session duration <30 sec → Value = $1
4. Enable rules and monitor for 7 days
5. Review value distribution in reporting
**Expected Impact:**
- Algorithm will optimize toward higher-engagement users
- May see 10-20% decrease in conversion volume
- Should see 30-50% improvement in lead quality (measured by show-up rate)
- Requires 2-week learning period for Smart Bidding to adapt
**Verification:**
- ✅ Conversion value rules not currently configured (checked 2025-10-24)
- ⚠️ Requires client approval (data-driven value assignment)
- ✅ Compatible with Maximize Conversion Value strategy
- ⚠️ Need to monitor for 7-14 days before evaluating effectivenessExample 3: LONG-TERM - Offline Conversion Tracking
#### ℹ️ 3. Implement Offline Conversion Tracking for Tour Attendance
**Current State:**
- Only tracking "contact_form" conversion (initial form submission)
- No tracking of actual tour attendance
- High no-show rate (~80%) but Google Ads doesn't know which leads showed up
- Algorithm optimizing for form fills, not quality attendees
**Recommendation:**
Implement offline conversion tracking to feed tour attendance data back to Google Ads
**Implementation Plan:**
**Phase 1: CRM Integration (Week 1-2)**
1. Work with client to access business CRM
2. Identify tour scheduling and attendance tracking fields
3. Map CRM data fields to Google Ads offline conversion schema
**Phase 2: API Setup (Week 2-3)**
4. Set up Google Ads Offline Conversion API access
5. Create conversion action "tour_attended" in Google Ads
6. Build data pipeline from CRM to Google Ads (daily sync)
**Phase 3: Testing (Week 3-4)**
7. Test with 1 week of historical data
8. Verify conversions appearing correctly in Google Ads
9. Confirm GCLID matching between initial conversion and attendance
**Phase 4: Activation (Week 4)**
10. Switch bidding optimization to "tour_attended" instead of "contact_form"
11. Monitor for 2-week learning period
12. Evaluate quality improvement
**Expected Impact:**
- Algorithm optimizes for users who actually attend tours (not just submit forms)
- Should see 50-70% improvement in show-up rate over 30 days
- May see initial conversion volume decrease as algorithm learns
- Long-term: Higher quality leads, better ROAS, happier client
**Dependencies:**
- ⚠️ Requires client CRM access and cooperation
- ⚠️ Requires development work (API integration)
- ⚠️ Requires minimum 30 conversions/month for Smart Bidding to work
- ℹ️ 4-6 week implementation timeline
**Success Metrics:**
- Show-up rate increases from 20% → 50%+ within 60 days
- Cost per attended tour becomes primary KPI
- Algorithm learns to identify high-intent users"What Was Ruled Out" Framework
Purpose: Document what was checked but didn't pan out, preventing redundant recommendations in future analyses.
Why This Matters:
- Shows thoroughness of investigation
- Prevents recommending already-implemented fixes
- Builds client trust (demonstrates due diligence)
- Helps future analysts avoid duplicate work
"What Was Ruled Out" Template
### ❌ {Idea/Recommendation}
**Initial Hypothesis:** {What we thought might be the problem}
**Verification Method:** {How we checked}
**Finding:** {Already implemented / Not applicable / Won't solve problem}
**Evidence:** {Specific data or settings that prove this}
**Conclusion:** {Why this isn't recommended}Example: Geographic Targeting Ruled Out
### ❌ Adjust Geographic Targeting to Exclude Out-of-State Traffic
**Initial Hypothesis:**
Campaign serving ads to users in Phoenix, Fresno, Portland (outside NYC) due to targeting misconfiguration
**Verification Method:**
- Reviewed campaign location targeting settings
- Checked included/excluded locations
- Verified targeting radius
**Finding:** Already correctly configured
**Evidence:**
- Location targeting: "New York, NY, United States" with 40-mile radius
- No additional locations included
- No broad targeting or "Presence or Interest" settings
- GA4 shows conversions from outside NYC, but campaign IS NOT targeting those locations
**Conclusion:**
Geographic discrepancy is due to IP geolocation inaccuracy (common for mobile users, VPNs, carrier IPs), NOT a targeting problem. The campaign settings are correct - do NOT change targeting.
**Supporting Data:**
- 83.3% of conversions from Android Webview (known for IP geolocation issues)
- 100% mobile traffic (mobile carrier IPs often mislocated)
- Actual user addresses (from form data) are in NYC, despite GA4 showing other citiesImplementation Timeline Template
Purpose: Provide week-by-week roadmap for all recommendations
## Implementation Timeline
| Week | Actions | Priority | Owner | Status |
|------|---------|----------|-------|--------|
| Week 1 (Current) | • Add `/blog/*` URL exclusions<br>• Exclude mobile app placements<br>• Add negative keywords for irrelevant terms | 🚨 High | Media Buyer | ⏳ Pending |
| Week 2 | • Implement conversion value rules<br>• Add audience signals (in-market potential customers)<br>• Monitor quality improvements | ⚠️ Medium | Media Buyer | ⏳ Pending |
| Week 3 | • Review conversion value distribution<br>• Adjust rules based on learning<br>• Begin offline conversion planning | ⚠️ Medium | Media Buyer + Client | ⏳ Pending |
| Week 4 | • Initiate CRM integration for offline conversions<br>• Build data pipeline<br>• Create "tour_attended" conversion action | ℹ️ Low | Developer + Media Buyer | ⏳ Pending |Success Metrics & Monitoring Template
Purpose: Define how to measure if recommendations are working
## Success Metrics & Monitoring
**Primary KPIs:**
1. **Show-up Rate** (tours attended ÷ tours booked)
- Current: ~20%
- Target: >50% within 30 days
- Measurement: Client CRM data
2. **Cost per Attended Tour** (spend ÷ tours attended)
- Current: ~$250 (estimated, based on 20% show-up rate)
- Target: <$100 within 60 days
- Measurement: Google Ads spend ÷ CRM tour attendance
3. **Conversion Rate from Service Pages** (conversions ÷ clicks on service pages)
- Current: Unknown (mixed with blog traffic)
- Target: Establish baseline after URL exclusions
- Measurement: GA4 landing page report + Google Ads
**Secondary KPIs:**
- Conversion volume (expect 20-30% decrease initially, then stabilize)
- CPA (may increase initially, but quality improves)
- Conversion value (if value rules implemented)
**Monitoring Frequency:**
- **Daily (Week 1):** Check for implementation errors, monitor conversion volume
- **Weekly (Weeks 2-4):** Review quality metrics, adjust rules as needed
- **Monthly:** Full analysis report comparing before/after
**Review Date:** {30 days from implementation}Prioritization Decision Tree
Use this tree to determine priority tier for each recommendation:
START: Is this recommendation verified as not already implemented?
└─ NO → Do NOT recommend (document in "What Was Ruled Out")
└─ YES → Continue
Can this be implemented in <1 hour with no approvals?
└─ YES → Is impact high (addresses root cause)?
└─ YES → 🚨 IMMEDIATE PRIORITY
└─ NO → ⚠️ MEDIUM PRIORITY (quick but not critical)
└─ NO → Continue
Does this require client approval or testing?
└─ YES → ⚠️ MEDIUM PRIORITY
└─ NO → Continue
Does this require >1 week implementation or development work?
└─ YES → ℹ️ LONG-TERM PRIORITY
└─ NO → ⚠️ MEDIUM PRIORITY (moderate effort)Quality Checks Before Recommending
Pre-Flight Checklist:
Before adding any recommendation to final report:
- Verified not already implemented (checked campaign settings on {date})
- Specific and actionable (not generic advice like "improve quality")
- Implementation steps provided (exact instructions, not just "do this")
- Expected impact quantified (% change, timeline, metric)
- Priority tier assigned (Immediate / Medium / Long-term)
- Verification evidence documented (how we confirmed it's not already done)
- No conflicts with other recommendations (actions don't contradict each other)
- Technically feasible (confirmed possible in Google Ads platform)
If ANY checklist item fails:
- Do NOT include recommendation
- Either fix the gap (add missing details) or document in "What Was Ruled Out"
Integration with Investigation Workflow
Pre-Recommendations (Pattern Analysis & Cross-Reference):
- lead-quality-pattern-analysis - Identifies red flags and issues
- ga4-campaign-cross-reference - Verifies what's already configured vs gaps
During Recommendations (This Skill):
- Apply prioritization decision tree to each finding
- Structure recommendations using templates
- Create "What Was Ruled Out" documentation
- Build implementation timeline
Post-Recommendations (Output):
- client-communication-standards - Format final report
- Include success metrics and monitoring plan
- Deliver with clear next steps
Real-World Example: Example PMAX Prioritization
Findings from Analysis:
- 5 red flags detected (🚨 Severe)
- 3 configuration gaps confirmed
- 2 hypotheses ruled out
Recommendations Generated:
🚨 IMMEDIATE (3 actions):
- Add
/blog/*URL exclusions → Addresses 76.2% blog traffic - Reduce budget during seasonal decline → Preserves budget for better timing
- Pause AI Max campaign → Underperforming, cannibalizing Pmax budget
⚠️ MEDIUM (2 actions): 4. Implement conversion value rules → Requires testing, client awareness 5. Review mobile app placements → Requires deeper placement report analysis
ℹ️ LONG-TERM (2 actions): 6. Dual thank-you page setup → Requires client dev work 7. Offline conversion tracking → Requires CRM integration (4-6 weeks)
❌ RULED OUT (2 hypotheses):
- Geographic targeting changes → Verified targeting correct, IP geolocation issue
- Add negative keywords → Already comprehensive list configured
Implementation Timeline:
- Week 1: All IMMEDIATE actions completed
- Week 2-3: MEDIUM actions implemented and monitored
- Week 4+: LONG-TERM planning initiated
Result:
Clear action plan with specific next steps, verified recommendations, and documented due diligence (ruled-out items)
When to Use This Skill
Auto-Invoked When:
- Generating lead quality recommendations
- Prioritizing investigation findings
- Creating implementation timelines
- Documenting "What Was Ruled Out"
- User asks "what should I do about {lead quality issue}"
Manual Invocation:
- Campaign audits (organizing findings)
- Client reports (structuring recommendations)
- Monthly reviews (prioritizing fixes)
When to Load Other Skills
| Skill | When |
lead-quality-pattern-analysis | Upstream — it identifies the red flags that become recommendations |
ga4-campaign-cross-reference | Upstream — it verifies what's already configured so you don't recommend a fix that's in place |
client-communication-standards | When formatting the prioritized plan into a client-facing report |
budget-recommendation-calculator | When a recommendation is a budget change — it carries the parallel prioritization framework for pacing fixes |
ga4-lead-quality-investigation | It orchestrates the full investigation and routes here for its Step-5 prioritization |
The full recommendation structure end to end lives in the Real-World Example above; ga4-cross-analysis gives the system overview of the workflow these recommendations conclude.
Created: 2025-11-01 Status: Active
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

