Agent skill

Gbp Suspension Recovery

by garrettjsmith in garrettjsmith/localseoskills

When the user's Google Business Profile has been suspended, disabled, or is under review.

MITAuto-check passedMarketing & SEO

Install Gbp Suspension Recovery

skills CLI
$ npx skills add garrettjsmith/localseoskills --skill gbp-suspension-recovery -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install garrettjsmith/localseoskills gbp-suspension-recovery --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/garrettjsmith/localseoskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gbp-suspension-recovery .claude/skills/gbp-suspension-recovery && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gbp-suspension-recovery
GitHub stars
121
Token cost
~2k tokens
SKILL.md length
948 words
Files
1
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

When the user's Google Business Profile has been suspended, disabled, or is under review.

  • Works in 5 steps: Identify the Cause → Fix ALL Issues → Request Reinstatement → …
  • S Google Business Profile has been suspended
  • SKILL.md covers Suspension Types, Common Suspension Causes, Prevention Checklist and Reinstatement Process, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Gbp Suspension Recovery is an agent skill from garrettjsmith/localseoskills. When the user's Google Business Profile has been suspended, disabled, or is under review. Also use when the user mentions "suspended," "GBP suspension," "listing disabled," "profile removed," "reinstatement," "Google suspended my business," "guideline violation," or "my listing disappeared." For general GBP optimization, see gbp-optimization.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Local SEO. The repository describes itself as: Open-source Claude SEO tool for local search visibility — skills, tool integrations, and automation templates that turn Claude into a Local SEO expert. The licence is MIT.

When your agent uses it

  • S Google Business Profile has been suspended
  • Is under review
  • The user mentions suspended
  • Listing disabled

Example prompts

  • “suspended,”
  • “GBP suspension,”
  • “listing disabled,”
  • “/gbp-suspension-recovery”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Identify the Cause
  2. Fix ALL Issues
  3. Request Reinstatement
  4. Wait and Follow Up
  5. Escalation (If Standard Process Fails)

What it can do on your machine

Read from SKILL.md and the folder at commit 405ce20. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gbp Suspension Recovery loads about 2k tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 948 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from garrettjsmith/localseoskills at commit 405ce20, republished under its MIT licence (© garrettjsmith). 948 words, ~2,014 tokens.

Download SKILL.mdSave it as .claude/skills/gbp-suspension-recovery/SKILL.md (or your agent's skills folder).
name
gbp-suspension-recovery
description
When the user's Google Business Profile has been suspended, disabled, or is under review. Also use when the user mentions "suspended," "GBP suspension," "listing disabled," "profile removed," "reinstatement," "Google suspended my business," "guideline violation," or "my listing disappeared." For general GBP optimization, see gbp-optimization.
metadata.version
1.0.0
metadata.author
Garrett Smith

GBP Suspension & Recovery

You are an expert in Google Business Profile guidelines, suspension types, and the reinstatement process. Your goal is to help businesses prevent suspensions and recover from them when they occur.

Suspension Types

Soft Suspension
  • Profile is disabled but still visible to the owner in GBP dashboard
  • Often triggered by automated quality checks
  • Can usually be resolved through standard reinstatement
  • Status shows as "Suspended" in the dashboard
Hard Suspension
  • Profile is completely removed from Google Maps and search
  • Often triggered by manual review or repeated violations
  • More difficult to reinstate
  • May require escalation to Google support
Pending Review / Verification Hold
  • Not technically a suspension, but profile is not live
  • Happens during initial verification or after major edits
  • Usually resolves within days, but can stall

Common Suspension Causes

Guideline Violations
  • Keyword-stuffed business name — #1 cause. Adding descriptors like "Best Plumber Buffalo NY" to your business name
  • Fake address — Using virtual offices, UPS Stores, co-working spaces, or PO Boxes
  • Multiple listings for the same business at the same address
  • Ineligible business type — businesses that don't qualify for GBP (online-only, non-customer-facing)
  • Misleading category — primary category doesn't match actual business
Quality Issues
  • Inconsistent information across web (NAP mismatches triggering automated review)
  • Bulk changes that trigger automated flags
  • Frequent major edits (address, name, category changes in quick succession)
  • Low-quality listing — incomplete profile, no reviews, no photos
  • Reported by competitors — competitor flags your listing (sometimes valid, sometimes spam)
Verification Problems
  • Failed video verification
  • Postcard never arrived or code expired
  • Multiple failed verification attempts
  • Address doesn't match business registration documents

Prevention Checklist

Do:

  • Use exact legal business name (DBA if applicable)
  • Use real physical address where you receive customers or run operations
  • Choose categories that accurately describe your business
  • Keep NAP consistent across all platforms
  • Make one change at a time (don't batch multiple edits)
  • Respond to Google-suggested edits promptly
  • Document everything (photos of storefront, business docs)
  • Keep GBP profile complete and active

Don't:

  • Add keywords to business name
  • Use virtual office addresses
  • Create duplicate listings
  • Make major changes to name + address + category simultaneously
  • Ignore pending "Suggest an edit" changes from Google
  • Use a home address for a storefront category

Reinstatement Process

Step 1: Identify the Cause

Before requesting reinstatement, figure out WHY you were suspended.

  • Review Google's GBP guidelines thoroughly
  • Check recent edits to the profile
  • Look for name, address, or category issues
  • Check for duplicate listings
  • Review any communication from Google
Step 2: Fix ALL Issues

Fix every potential violation before requesting reinstatement. Google may re-review the entire listing.

  • Remove keywords from business name
  • Verify address is legitimate and accurate
  • Remove duplicate listings
  • Fix category if inaccurate
  • Ensure NAP consistency across the web
  • Prepare documentation proving legitimacy
Step 3: Request Reinstatement

Primary method: GBP support form

  • Go to support.google.com/business
  • Select "Profile disabled or suspended"
  • Submit reinstatement request with documentation

Required documentation may include:

  • Business license or registration
  • Utility bill showing business address
  • Lease agreement or proof of address
  • Professional license (for regulated industries)
  • Photos of business location (exterior with signage, interior)
  • Tax documents showing business name and address
  • Vehicle wraps or branded materials (for SABs)
Step 4: Wait and Follow Up
  • Initial response: typically 3-7 business days
  • If denied: review the reason, fix additional issues, resubmit
  • Don't spam reinstatement requests — one at a time, wait for response
  • Follow up after 7 business days if no response
Show full SKILL.md (395 more words)Show less
Step 5: Escalation (If Standard Process Fails)
  1. Google Business support chat/phone: Request escalation to specialist team
  2. Google Business community forum: Post with details, top contributors may escalate
  3. Twitter/X @GoogleMyBiz: Sometimes gets attention
  4. Google Business redressal form: For competitor-caused issues
  5. Legal/formal complaint: Last resort for legitimate businesses

SAB-Specific Suspension Issues

SABs face additional suspension risk:

  • Home address suspensions (Google questioning legitimacy)
  • Service area too broad triggering review
  • Category mismatch (storefront category on an SAB)
  • Competitor reports claiming business doesn't exist at the location

SAB Prevention:

  • Have clear documentation of business operations
  • Photos of service vehicles, equipment, uniforms
  • Customer invoices showing the business name
  • Business registration matching GBP info
  • Don't try to show a home address as a storefront

Multi-Location Suspension Issues

  • One bad location can trigger review of all locations
  • Bulk-verified locations sometimes get mass-suspended
  • Agency accounts with multiple clients can cascade suspensions
  • Use organization-level management to isolate risk

Prevention at scale:

  • Audit every location for guideline compliance before claiming
  • Don't bulk-edit many locations simultaneously
  • Maintain documentation for every location
  • Have a designated GBP compliance process

Timeline Expectations

ScenarioTypical Timeline
Soft suspension, first occurrence3-7 days for reinstatement
Hard suspension, clear violation fixed1-3 weeks
Repeated suspension2-4 weeks, may require escalation
Competitor-triggered, no violation1-2 weeks
Mass suspension (multi-location)2-6 weeks
Appeals after denial1-3 weeks per attempt

Post-Reinstatement

After reinstatement:

  • Don't immediately make more edits — let the listing stabilize
  • Monitor for 30 days for any re-suspension
  • Slowly bring the profile back to full optimization
  • Document what caused the suspension to prevent recurrence
  • Set up monitoring for unauthorized edits going forward

Task-Specific Questions

  1. What type of suspension? (soft, hard, pending review)
  2. When did the suspension occur?
  3. Any recent changes to the profile before suspension?
  4. Business type — storefront, SAB, hybrid?
  5. Any previous suspensions?
  6. What documentation is available? (license, lease, utility bills)

What to Do Next

What You FoundNext ActionSkill
Listing reinstated successfullyRe-optimize the profile carefully, staying within guidelinesgbp-optimization
Suspension was caused by bulk/API operationsReview API usage patterns before resuminggbp-api-automation
Multiple locations affectedAudit all locations for similar issues before they get suspended toomulti-location-seo
Listing reinstated but rankings haven't recoveredRun a geogrid scan — suspension history can have lingering ranking effectsgeogrid-analysis

Default next step: After reinstatement, wait 2 weeks before making any profile changes. Then re-optimize conservatively.

© garrettjsmith, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/gbp-suspension-recovery of garrettjsmith/localseoskills.

Open the folder on GitHubat commit 405ce20

Compare with similar skills

Gbp Suspension Recovery next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gbp Suspension Recovery compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gbp Suspension Recovery this skillgarrettjsmith/localseoskills121—~2kAutomated safety check: PassMIT
FLOW SEO FrameworkAgriciDaniel/claude-seo19k2 repos~1.4kAutomated safety check: PassMIT
Google Mapscablate/mcp-google-map469—~909Automated safety check: PassMIT
Google Maps Local SEOcablate/mcp-google-map469—~633Automated safety check: PassMIT
Google Maps Travel Planningcablate/mcp-google-map469—~710Automated safety check: PassMIT
Universal SEO AnalysisAgriciDaniel/claude-seo19k—~4.9kAutomated safety check: PassMIT

Similar skills

  • FLOW SEO Framework

    AgriciDaniel/claude-seo

    Brings the FLOW framework's stage-specific SEO prompts into the agent, from keyword discovery through backlinks, on-page work and conversion to local SEO, loaded on demand.

    19k GitHub starsUsed in 2 repos~1.4k tokens
    Marketing & SEOAuto-check passed
  • Google Maps

    cablate/mcp-google-map

    Search places, resolve addresses, compare routes, inspect neighborhoods, and retrieve geographic or environmental facts through the standalone @cablate/mcp-google-map CLI.

    469 GitHub stars~909 tokensUpdated 14 days ago
    Marketing & SEOAuto-check passed
  • Google Maps Local SEO

    cablate/mcp-google-map

    Analyze Google Business Profile visibility, geographic grid rankings, local search keywords, and nearby competitors through the standalone Google Maps CLI.

    469 GitHub stars~633 tokensUpdated 14 days ago
    Marketing & SEOAuto-check passed
  • Google Maps Travel Planning

    cablate/mcp-google-map

    Build evidence-backed day trips, multi-day itineraries, and efficient stop sequences with Google Maps data through the standalone CLI.

    469 GitHub stars~710 tokensUpdated 14 days ago
    Marketing & SEOAuto-check passed
  • Universal SEO Analysis

    AgriciDaniel/claude-seo

    Hub for site-wide SEO work: audits, technical checks, schema, content quality, local, hreflang and AI-search readiness, run through slash commands.

    19k GitHub stars~4.9k tokensUpdated 6 days ago
    Marketing & SEOAuto-check passed
  • SEO Project Setup

    petera2c/simple-table

    Set up a durable local SEO workspace with project context, notes, goals, positioning, preferences, MCP checks, and Search Console data intake.

    229 GitHub starsUsed in 1 repo~1.5k tokens
    Marketing & SEOAuto-check passed

More from garrettjsmith/localseoskills

All 38 skills in this repo
  • Gbp API Automation

    garrettjsmith/localseoskills

    When the user wants to programmatically manage Google Business Profiles at scale via API, automate GBP updates, build GBP management tools, or integrate GBP data into their systems.

    121 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Gbp Posts

    garrettjsmith/localseoskills

    When the user wants to create, schedule, or optimize Google Business Profile posts.

    121 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Local Content Briefs

    garrettjsmith/localseoskills

    Generate complete semantic content briefs for local SEO content — location pages, service pages, blog posts, FAQ content, and pillar pages.

    121 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Brief

    garrettjsmith/localseoskills

    Manages persistent work state (briefs) for local SEO engagements.

    121 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check: warnings
  • Local Content Strategy

    garrettjsmith/localseoskills

    Build a complete local content strategy from keyword research output.

    121 GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Local Falcon Tool

    garrettjsmith/localseoskills

    When the user wants to run a geogrid scan, check existing scan reports, track ranking trends over time, monitor GBP changes via Falcon Guard, or analyze reviews.

    121 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Gbp Suspension Recovery

What does Gbp Suspension Recovery do?

When the user's Google Business Profile has been suspended, disabled, or is under review. Gbp Suspension Recovery is an agent skill from garrettjsmith/localseoskills. When the user's Google Business Profile has been suspended, disabled, or is under review.

When should I use Gbp Suspension Recovery?

Gbp Suspension Recovery fits situations like: S Google Business Profile has been suspended; is under review; the user mentions suspended; listing disabled.

How do I install Gbp Suspension Recovery in Claude Code?

Run `npx skills add garrettjsmith/localseoskills --skill gbp-suspension-recovery -a claude-code`. Or copy the skill folder (skills/gbp-suspension-recovery in garrettjsmith/localseoskills) into .claude/skills/gbp-suspension-recovery in your project. Claude Code loads it when a task matches its description.

How do I install Gbp Suspension Recovery in Codex?

Run `npx skills add garrettjsmith/localseoskills --skill gbp-suspension-recovery -a codex`. Or copy the skill folder (skills/gbp-suspension-recovery in garrettjsmith/localseoskills) into .agents/skills/gbp-suspension-recovery in your project. Codex loads it when a task matches its description.

Can I use Gbp Suspension Recovery in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add garrettjsmith/localseoskills --skill gbp-suspension-recovery -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gbp-suspension-recovery, .gemini/skills/gbp-suspension-recovery, .github/skills/gbp-suspension-recovery and .opencode/skills/gbp-suspension-recovery in your project.

What does Gbp Suspension Recovery need to run?

SKILL.md names no scripts, command-line tools or credentials: Gbp Suspension Recovery is instructions for the agent only.

Does Gbp Suspension Recovery access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Gbp Suspension Recovery safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gbp Suspension Recovery use?

Gbp Suspension Recovery is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gbp Suspension Recovery use?

About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gbp Suspension Recovery?

Skills that share tags, products or a category with Gbp Suspension Recovery: FLOW SEO Framework (AgriciDaniel/claude-seo, 19k stars), Google Maps (cablate/mcp-google-map, 469 stars), Google Maps Local SEO (cablate/mcp-google-map, 469 stars) and Google Maps Travel Planning (cablate/mcp-google-map, 469 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gbp Suspension Recovery?

garrettjsmith (a GitHub user) maintains it in garrettjsmith/localseoskills, which has 121 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on August 15, 2026.

Source: garrettjsmith/localseoskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.