Skip to content

gooseworks-ai/goose-skills / skills/marketing/improve-search-visibility

improve-search-visibility

Verified

SEO and AI-answer visibility. Use for a site SEO or technical audit with ranked fixes, competitor keyword and topic gaps, a topic cluster, SEO metrics for domains, a programmatic SEO page-set plan, or checking where ChatGPT and Google name the brand. Delivers the requested audit, comparison, map or blueprint with dated evidence and clear data limits. Also covers app store listings and local search. Drafts changes; never edits live. Full pages go to make-content; paid search goes to run-paid-campaigns.

FileKindSize
SKILL.mdskill md11.0 KB
references/app-store-listing.mdmarkdown2.4 KB
references/battlegrounds.mdmarkdown3.8 KB
references/citation-protocol.mdmarkdown8.4 KB
references/entity-and-local.mdmarkdown4.3 KB
references/finished-fix-examples.mdmarkdown8.7 KB
references/foundation-check.mdmarkdown7.5 KB
references/free-pass.mdmarkdown4.7 KB
references/gap-to-fix.mdmarkdown5.5 KB
references/page-map.mdmarkdown4.8 KB
references/prioritising.mdmarkdown2.9 KB
references/question-list.mdmarkdown5.5 KB
references/report-template.mdmarkdown4.6 KB
references/rival-content-map.mdmarkdown4.3 KB
references/run-memory.mdmarkdown15.0 KB
references/seo-data.mdmarkdown6.7 KB
references/seo-jobs.mdmarkdown9.7 KB
skill.meta.jsonconfig6.7 KB
tests/fixture-reports/audit.jsonconfig6.9 KB
tests/fixture-reports/audit.mdmarkdown5.5 KB
tests/fixture-reports/cluster.jsonconfig6.9 KB
tests/fixture-reports/cluster.mdmarkdown4.0 KB
tests/fixture-reports/gaps.jsonconfig5.7 KB
tests/fixture-reports/gaps.mdmarkdown3.8 KB
tests/fixture-reports/metrics-export.jsonconfig3.5 KB
tests/fixture-reports/metrics-export.mdmarkdown1.9 KB
tests/fixture-reports/metrics-missing.jsonconfig3.3 KB
tests/fixture-reports/metrics-missing.mdmarkdown1.8 KB
tests/fixture-reports/metrics-traffic-only.jsonconfig3.9 KB
tests/fixture-reports/metrics-traffic-only.mdmarkdown2.1 KB
tests/fixture-reports/metrics.jsonconfig5.0 KB
tests/fixture-reports/metrics.mdmarkdown3.1 KB
tests/fixture-reports/pseo.jsonconfig9.5 KB
tests/fixture-reports/pseo.mdmarkdown6.5 KB
tests/fixtures/coldfield.jsonconfig21.4 KB
tests/run-fixtures.pyscript7.7 KB
tests/test-by-hand.mdmarkdown9.4 KB

references/page-map.md

View on GitHub
# The page map (the search roadmap)

Use for a search roadmap, subject cluster or planned new pages. Map intents to the pages that answer them; use `seo-jobs.md` for the requested cluster, gap or pSEO deliverable. This roadmap can exceed the recommendation count. Read it before updating, preserving rows outside this job's scope.

## Shape (`search/page-map.md`)
```
Do this first: <the one move and why — the report's "So, do this first" line, copied>
Page map — <Brand> — <YYYY-MM-DD> v<N> · country <cc> · demand source: Search Console impressions (last 3 months) | none (ranked by value × winnability)

| Cluster | Questions (ids) | Primary query | Demand | Page that answers it | Best position now | State | Winnable | Priority | Owner | Quarter | This run's evidence |
| sensitive-skin moisturizer | Q1, Q3, Q4 | moisturizer for sensitive skin | 12.4k impr. | /collections/moisturizers | not in top 10 | rewrite | 3 | 1 | store admin | Q4-2026 | ChatGPT 0/3, cites 2 listicles; page has no answer-first intro |
| X vs Y | Q7 | x vs y | — | none | — | needed (brief) | 2 | 3 | writer | Q1-2027 | rivals' own "vs" pages cited 6/8 runs |
| brand facts | Q9–Q11 | halden reviews | 900 impr. | /pages/about + profiles | #1 | fix | 3 | 2 | founder | now | Crunchbase repeats 2022 positioning |
```
- **State:** ok · rewrite · fix (profile or foundation) · needed (brief) · merge (two pages compete for one cluster; proposal with redirect risk) · blocked (foundation blocker) · parked (not winnable now, or a comparison when the human said not to name competitors; why).
- **Demand:** always name the source. In order: Search Console impressions summed over the cluster's queries (when shared); Google Keyword Planner ranges (when the brand shares its Ads account); Google Trends relative interest and autocomplete presence (free, in the browser — relative, not counts); a vendor's AI prompt-volume estimate only if the brand already has that account, labelled "estimate". None → "no demand data, ranked by judgment". Never invent volumes.
- **Priority:** 1 = do first. Blockers on key question pages and false brand facts rank first; then near-winners (positions ~4–15 or cited sometimes); then missing pages by demand × winnability; prestigious-but-hopeless clusters are parked with the reason.
- **Quarter:** "now" for this-week fixes; then fill quarters in priority order at the human's stated capacity (pages a month from intake), so the map reads as a realistic quarterly roadmap. Those sizes are useful for recurring visibility samples, not limits on an audit or subject map. For a one-off topic cluster, give a build order without asking for publishing capacity; date a calendar only when capacity is known.

## How priorities and briefs come from it
- Ranked recommendations follow the request and `prioritising.md`; recurring visibility checks default to five changes the named person can ship this week.
- Create briefs for requested pages and the priority pages selected for the next production step. A complete map still lists the other pages with their intent, links and priority; it need not include a full brief for each.
- On a re-run, rows whose fix shipped are re-checked against this run's evidence; a row that moved changes state, one that didn't keeps its priority with a note.

## Page brief — make-content's brief input shape (`search/briefs/<page-slug>.md`)
```
Page brief — <working title> · from the search roadmap, topic "<cluster>" · <date>
Cluster: <name> · Intent: learn | do | decide | trust | be convinced · Stage: discovery | problem | comparison | price | brand
Format · where it publishes (URL to create) · by when (the map's quarter)
Audience: <role/segment>, their situation, what they already know
Questions the page must answer word for word: <AI form> / <Google form> for each question
Information gain: what the cited winners say (URLs, date read) → what ours must add
H2 outline (as claims): …
Facts the page must state: <fact> — source: "Claims you may use" fact | product record field | [PROOF NEEDED]
Claims allowed / never say: from the claims gate (scoped sign-off status)
Competitor names: allowed | not allowed (the human's stance) · public source for each competitor fact
Internal links to add: the hub page for this topic ↔ this page (both directions); this page ↔ its closest sibling pages in the same cluster; glossary or explainer pages → this page where the term appears — each with the page, the exact anchor text and where in the page it sits
Markup: Product | Organization | LocalBusiness | SoftwareApplication | Article | none
Format · length: <a format name from make-content's format list> · <target words>
CTA: <action> → to confirm with you
Live data: the answers this rests on (question, engine, date)
```
make-content's drafts carry this brief's path on their first line, so the next run can see which briefs became pages.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall