hoo-keyword-intellisted
Install: claude install-skill shalintripathi/organic-os
# Keyword intelligence (tiered)
0. Read site-profile.yaml (google_ads.status, keywords.targets, competitors,
geos, languages). Source env from `~/.config/organic-os/<site-slug>.env`
if present.
## Tier detection (once per session)
Run: `PYTHONPATH="$CLAUDE_PLUGIN_ROOT/lib" python3 -c "..."` snippet importing
`hoo.google_ads.tier`: if env vars missing -> tier "none". Else build
real_client() and `tier.detect()` -> basic|explorer. Tell the user which tier
is active and what that enables.
## basic (or standard)
1. Ideas: `keyword_ideas.run` with profile target keywords as seeds AND, per
competitor, `site_seed=<competitor domain>`. Cache dir: `<brain>/keywords/cache/`.
2. Gap: ideas(own site_seed) vs ideas(competitor site_seed) - keywords in
their set, absent from ours, volume >= 100. Rank by volume x profile fit.
3. Metrics for the shortlist: `historical.run` (batches of 200 handled inside).
4. Write `runs/YYYYMMDD-keywords/` (01-ideas.json, 02-gaps.json, REPORT.md)
and update `keywords/tracking.yaml` targets the user confirms (additions
are a strategy mutation -> create_item kind="strategy" + approval gate).
## explorer
Own-account GAQL only: search_term_view mining (queries with impressions and
no matching target), keyword_view quality scores. State plainly: "Planner
blocked at Explorer tier - apply for Basic (https://github.com/shalintripathi/organic-os/blob/main/plugin/docs/credentials/google-ads-token.md, also at $CLAUDE_PLUGIN_ROOT/docs/credentials/go