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.
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.
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 + intent —
seo/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 prompts —
geo/serp(run "best [trade] near me" and problem/cost questions as AI-Mode prompts; capture the answer, cited sources, and theis_targetflag 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/serpforsite:reddit.com <problem>(e.g.site:reddit.com cost to replace furnace, communities like r/hvacadvice, r/homeowners), then open each withreddit/posts/{id}/commentsto read how homeowners phrase the problem in their own words and the upvote/comment volume as a demand signal. - News + seasonal hooks —
news/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
- 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.mdfirst if it exists. - Mine search demand. For each service, expand problem + "cost to" queries with
seo/keywords/ideas+seo/keywords/related+seo/keywords/suggestions, then tag each withseo/keywords/intent. Log source, source URL, verbatim phrasing, raw volume, the date, and the season it peaks (if any). - Mine community + AI + seasonal questions. Find Reddit threads via
seo/serpsite:reddit.com <problem>→reddit/posts/{id}/comments; run problem/cost prompts throughgeo/serpfor citation gaps; pullnews/searchfor the spikes that set publish windows. - 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.
- 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.
| Axis | What it measures | 1 | 3 | 5 |
|---|---|---|---|---|
| Demand | Volume (overview) / repetition across sources | thin, single source | moderate, steady, 2 sources | high volume or echoed across 3+ sources |
| Winnability | How beatable the current results are (seo/geo/serp) | strong fresh comprehensive pages | mixed; some thin/dated | thin, generic, off-topic, or no local owner |
| Intent | How close to hiring (seo/keywords/intent) | trivia / pure curiosity | problem diagnosis | cost / 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 viasite:reddit.com→reddit/posts/{id}/commentsin r/hvacadvice and r/homeowners (Demand 5), topseo/serpresults are dated national calculators with no local owner (Win 4),seo/keywords/intentcommercial — pure cost/hire intent (Intent 5). Base = 5 × (4 + 5) = 45;news/searchshows 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/serpfor "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.
Related Skills
- 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.
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
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