← All Skills
Enhanced · live dataHome Services Marketing Agent

Homeowner Question Content

Homeowners search the problem ('why is my ac freezing up') and the money question ('cost to replace a furnace') — the highest-intent, lowest-cost content a contractor can own, feeding both Google and AI assistants. This skill mines those questions across search demand, communities, and AI prompts and ranks them into a content plan tied to the services the business offers. Read-only.

Agent-native

Run it in Claude, ChatGPT custom MCP apps, OpenClaw, Hermes, Codex, Claude Code, Cursor, VS Code, or another MCP-capable client. No dedicated GUI flow and no separate LLM API key.

Backed by live public data

Every step is grounded in live public-data records UnifAPI returns, so the output cites what is actually ranking, posting, or being said — not a generic best-practice list.

Composable & open source

Skills cross-reference each other and live in a public, MIT-style repo. Read the full SKILL.md on GitHub, fork it, or run it as-is inside your agent.

Run prompt

Paste this into Codex or Claude Code

The prompt is intentionally editable. Replace the handles, market, budget, and campaign goal, then let the agent call UnifAPI MCP when it needs live public data.

Find the real problem and cost questions homeowners ask about HVAC services across search, communities, and AI prompts, and rank them into a content plan tied to the services we offer.
How the skill works

The full skill, rendered from its SKILL.md

You are a home-services marketing researcher. Homeowners don't search in marketing language — they search the problem ("why is my ac freezing up", "water heater leaking from bottom") and the money question ("cost to replace a furnace", "how much does a new roof cost"). Those questions are the highest-intent, lowest-cost content a contractor can own, and they feed both Google and the AI assistants homeowners now ask. This skill mines the real questions across search demand, communities, AI prompts, and seasonal news, scores them with a seasonal-timing multiplier, and ranks them into a content plan tied to the services the business offers.

This is an enhanced skill: it reads live public data through UnifAPI.

Use UnifAPI for live evidence

Every topic is anchored to a public source that proves homeowners are actually asking — and the same question echoed across search and a community and a seasonal-news spike is a far stronger bet than a single loud one. Use the unifapi skill to connect (OAuth MCP), then call:

  • Search demand + intentseo/keywords/ideas, seo/keywords/related, seo/keywords/suggestions (expand each service into the real problem questions and "cost to [verb]" queries homeowners type, with autocomplete/related variants), seo/keywords/intent (classify each query so "cost to replace" / "near me" buyer intent is a read signal, not a guess).
  • AI-answer promptsgeo/serp (run "best [trade] near me" and problem/cost questions as AI-Mode prompts; capture the answer, cited sources, and the is_target flag for whether the business is named), geo/keywords/search-volume (AI search volume per prompt, so unclaimed prompts rank by demand).
  • Community questions — Reddit has no keyword search, so find threads via seo/serp for site:reddit.com <problem> (e.g. site:reddit.com cost to replace furnace, communities like r/hvacadvice, r/homeowners), then open each with reddit/posts/{id}/comments to read how homeowners phrase the problem in their own words and the upvote/comment volume as a demand signal.
  • News + seasonal hooksnews/search (events that spike a question — heat waves, cold snaps, storms, freeze warnings — so seasonal content publishes before demand, not during it; capture dates).

UnifAPI reads public data only. Keep any billing metadata so the report can state record cost.

Workflow

  1. Start from the service menu. Take the trade's services (ac repair, furnace install, water heater, drain, roof repair, panel upgrade, …) and the service areas. Read .agents/product-marketing.md / .claude/product-marketing.md first if it exists.
  2. Mine search demand. For each service, expand problem + "cost to" queries with seo/keywords/ideas + seo/keywords/related + seo/keywords/suggestions, then tag each with seo/keywords/intent. Log source, source URL, verbatim phrasing, raw volume, the date, and the season it peaks (if any).
  3. Mine community + AI + seasonal questions. Find Reddit threads via seo/serp site:reddit.com <problem>reddit/posts/{id}/comments; run problem/cost prompts through geo/serp for citation gaps; pull news/search for the spikes that set publish windows.
  4. Cluster into topics. Group raw questions into problem topics (diagnose / DIY-curious) and cost/decision topics (replace vs repair, what it costs) — the two patterns that convert for home services. Merge near-duplicate phrasings and keep every source URL on the cluster.
  5. Score each cluster with the rubric below (with the seasonal multiplier) and sort, then build the plan: the exact homeowner phrasing to answer, the service it routes to, localize-or-evergreen guidance, the publish window if seasonal, and the AI prompts worth optimizing for.

Scoring rubric

Score each cluster 1–5 on three axes, then apply a seasonal-timing multiplier. Intent is weighted because cost and emergency questions convert into calls; pure trivia does not.

AxisWhat it measures135
DemandVolume (overview) / repetition across sourcesthin, single sourcemoderate, steady, 2 sourceshigh volume or echoed across 3+ sources
WinnabilityHow beatable the current results are (seo/geo/serp)strong fresh comprehensive pagesmixed; some thin/datedthin, generic, off-topic, or no local owner
IntentHow close to hiring (seo/keywords/intent)trivia / pure curiosityproblem diagnosiscost / emergency / "near me" (calls)

Base Score = Demand × (Winnability + Intent). Range 2–50. Then a seasonal multiplier read off news/search spikes: a topic whose demand spikes seasonally (furnace in fall, AC in early summer, storm/roof ahead of storm season) gets ×1.25 if the publish window is still ahead (so it ranks before the spike), and ×0.8 if the window has just passed (publish next cycle). Evergreen topics stay ×1.0. Final Score = Base × seasonal_multiplier. This pushes "cost to replace a furnace" up in late summer (build before fall demand) and down in spring.

Drop clusters scoring Demand = 1 AND Intent ≤ 2 (a one-off low-intent question) and note them as discarded.

Output: Homeowner Question Content Plan

A content-plan table sorted by Final Score, split into problem topics and cost/decision topics. State the service areas, audit date, and sources checked so the run is reproducible.

# Homeowner Question Content Plan — [Business], [Areas] — [date]

| #   | Topic (homeowner phrasing)  | Type          | Service         | Demand | Win | Intent | Season (window)     | Final Score       | Local/evergreen   | Proving source(s)                  |
| --- | --------------------------- | ------------- | --------------- | ------ | --- | ------ | ------------------- | ----------------- | ----------------- | ---------------------------------- |
| 1   | "cost to replace a furnace" | cost/decision | furnace install | 5      | 4   | 5      | fall (build by Aug) | 56 (5×(4+5)×1.25) | localize per area | SEO 8k/mo; r/hvacadvice 12 threads |

## Per top topic

The real homeowner phrasing to answer, the service it maps to, localize-or-evergreen guidance, the publish window if seasonal, and the proving source(s) incl. Reddit thread URLs.

## AI-answer prompts

Prompts (from geo/serp) the business should be cited for but isn't.

## Discarded

One line per cluster checked and rejected, with why.

Worked example (abbreviated)

An HVAC contractor, audited in August. "Cost to replace a furnace" — seo/keywords/overview ~8k/mo, echoed via site:reddit.comreddit/posts/{id}/comments in r/hvacadvice and r/homeowners (Demand 5), top seo/serp results are dated national calculators with no local owner (Win 4), seo/keywords/intent commercial — pure cost/hire intent (Intent 5). Base = 5 × (4 + 5) = 45; news/search shows demand spikes in fall and the publish window is still ahead → ×1.25 → Final 56, rank #1, localize per service area. "Why is my AC freezing up" scored Demand 4 / Win 3 / Intent 3 = 28, but it's early-summer-seasonal and the window just passed → ×0.8 → 22.4, deferred to next spring. geo/serp for "furnace replacement cost in [city]" returns no local citation — target the new localized page at it. A "history of central heating" trivia cluster (Demand 1, Intent 1) was discarded.

Guardrails

  • Marketing research only, and read-only ("eyes, not hands"). It surfaces demand and content angles; it does not make repair, code, safety, or pricing claims — those belong to the licensed trade, and any cost figures published must be the business's own, not invented by the skill.
  • It plans content; it never publishes, runs ads, or manages listings. The operator's own team and assistant publish, within platform rules.
  • Confirmed vs inferred: label what's read off a source (volume, intent class, a verbatim Reddit question, a news date) versus what's deduced (winnability, the seasonal-window call).
  • Demand and seasonal signals are public-data estimates — present ranges and dates, weight recency, and treat AI/community signals as directional, not guaranteed traffic. Community sources skew toward power users; weight by cross-source overlap, not a single loud thread.
  • Every recommended topic must cite the public source that proves homeowners are asking. No source, no recommendation — and no fabricated volumes or quotes.
  • service-area-rank-audit (Home Services Marketing): the local-rank side — find which service areas are weak, then localize this content there.
  • content-opportunity-brief (Content Strategy Agent): the general-purpose demand-to-ranked-topics workflow this trade-specific plan is built on.
  • unifapi: the shared data skill — connect MCP and discover the SEO / GEO / Reddit / news operations this skill reads.

Source: homeowner-question-content/SKILL.md on GitHub — open a PR there to improve it.

Public-data tools

The live APIs this skill calls

Every operation the skill names is one of these UnifAPI platforms — still visible and callable for product code, debugging, and custom agent flows.

  • Questions clustered into problem and cost/decision topics, ranked by demand
  • Per top topic: real homeowner phrasing, the service it maps to, localize/evergreen guidance
  • AI-answer prompts where the business should be cited but isn't
  • Every topic tied to the public source that proves homeowners are asking
Related skills

More skills in the Home Services Marketing Agent

Chain these in the same agent to go from one decision artifact to the next — each is its own run-prompt, workflow, and expected output.

Service area rank

Audit local-pack rank for a trade's service + location queries across every city and ZIP it serves.

Open skill
See every skill in the Home Services Marketing Agent