Documents

geo-update

Update the installed SEO + GEO skills and the seogeo CLI to the latest release. Reports the installed version, the latest published version, what changed, and reinstalls the skill set across every detected agent tool. Use when the user says "update geo", "update skills", "upgrade seogeo", "aggiorna", or asks whether a newer version exists.

What it does

The skill document

Update the SEO + GEO toolkit

The skills and the seogeo binary version together. Updating means upgrading the binary, then reinstalling the skills that ship inside it.

Step 1 — Report the current state

seogeo --version
seogeo install --list --json

install --list prints every supported agent tool, whether it is detected on this machine, and where its skills live. Show the user the installed version and the detected targets before changing anything.

If seogeo is not found, the toolkit is not installed. Point the user at the install command rather than trying to repair the installation:

curl -fsSL https://raw.githubusercontent.com/asale-ai/seo-geo-skill/main/install.sh | sh

Step 2 — Check for a newer release

curl -fsSL https://api.github.com/repos/asale-ai/seo-geo-skill/releases/latest \
  | grep '"tag_name"'

Compare against seogeo --version. If they match, tell the user they are current and stop — do not reinstall for no reason.

Step 3 — Upgrade the binary

The install script is idempotent and replaces the binary in place:

curl -fsSL https://raw.githubusercontent.com/asale-ai/seo-geo-skill/main/install.sh | sh

On Windows PowerShell:

irm https://raw.githubusercontent.com/asale-ai/seo-geo-skill/main/install.ps1 | iex

The script verifies the release checksum before installing. If verification fails it aborts without touching the existing binary — report the failure verbatim and stop.

Step 4 — Reinstall the skills

The new binary carries the new skills:

seogeo install --target all

This writes to every agent tool detected on the machine (Claude Code, Codex CLI, Gemini CLI, OpenCode, and any AGENTS.md-based agent) and skips the ones that are not present. To target one tool:

seogeo install --target claude
seogeo install --target codex

Preview without writing:

seogeo install --target all --dry-run --json

Step 5 — Verify

seogeo --version
seogeo commands --json | head -20
seogeo install --list

Confirm the version advanced and that the skill count matches what install --list reports. Tell the user which tools were updated and remind them that Claude Code picks up new skills on the next session start.

What is preserved

Updating never touches user state. These survive an upgrade:

State	Location
Drift baselines	`~/.cache/seogeo/drift/baselines.db`
CRM prospects	`/seogeo/prospects.json`
DataForSEO cost ledger	`/seogeo/dataforseo-costs.json`
Google API config	`~/.config/seogeo/google-api.json`
Backlink API config	`~/.config/seogeo/backlinks-api.json`

Skill files are overwritten. If the user edited a bundled skill, tell them to copy it to a new name before updating.

Related skills

seo-geo-skill

Bootstrap the SEO + GEO skill suite — installs the seogeo binary and writes all 48 SEO/GEO skills into every agent tool on this machine. Use when the user has just installed this skill and nothing else works yet, or says "set up seo skills", "install seogeo", "seogeo not found", "bootstrap geo skills", or asks why an SEO/GEO command is missing.

1 installs

seo-geo-optimizer

Optimize any website for SEO and GEO (AI search engines) — keyword strategy and clustering, site architecture and multilingual URL structure, page-level on-page SEO, AI-citation-ready content, topical-authority planning, internal linking, and structured-data schema