Communitygithub.com

PeakWorkflowSolutions/pws-portfolio

Runs an AI Assistant Discoverability Audit (GEO/AEO) for a local service business — crawler access, llms.txt, content extractability, answer-shaped content, schema.org, NAP consistency, and live citation testing — output as a findings table + prioritized action list.

pws-portfolio 是什麼?

pws-portfolio is a Claude Code agent skill that runs an AI Assistant Discoverability Audit (GEO/AEO) for a local service business — crawler access, llms.txt, content extractability, answer-shaped content, schema.org, NAP consistency, and live citation testing — output as a findings table + prioritized action list.

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PeakWorkflowSolutions/pws-portfolio/tree/HEAD/skills/ai-discoverability-audit

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

AI Assistant Discoverability Audit (GEO/AEO)

Purpose

Help local service businesses become accurately discoverable and citable by AI assistants. This means: their real business info (name, address, phone, hours, credentials) is consistent everywhere an AI might pull it from; their site has genuine, well-structured answer content instead of placeholder text; their site is technically accessible to AI crawlers; and gaps are diagnosed first, without alarmism, before any fixes begin.

This is a research/audit step only. Do not start fixing anything found without the user confirming scope first.

Before starting: gather

  • Client's full legal name as it should appear everywhere
  • Business/brokerage name (and team name if different)
  • Business address and phone number
  • Primary website URL
  • Any known profiles (website, social accounts, directory listings)

If this is a new business/client, suggest storing this audit's findings in a dedicated project (or a new doc within one) so the client's data stays separate from this reusable process — one project per business/client keeps things organized across multiple engagements.

Checks to run

  1. Crawler access — robots.txt allows AI bots (GPTBot, ClaudeBot, PerplexityBot, Google-Extended)
  2. llms.txt presence
  3. Content extractability — plain HTML vs. JS-locked, and whether pages actually contain real (not placeholder/template) content
  4. Answer-shaped content — FAQ/direct-answer formatting an AI could extract and cite
  5. Schema.org structured data
  6. Third-party profile consistency (NAP: name, address, phone) across every platform found
  7. Live citation test — actually query search/AI assistants and report what surfaces, including low-quality directory sites if found

Tooling caveats — expect these every time

  • Many agent/brokerage sites block automated fetching (robots.txt). If a fetch is blocked, do not try to bypass it — report the item as "can't verify automatically" and note it needs a manual PageSpeed Insights run (pagespeed.web.dev) and a manual view-source check.
  • Google Maps listings require JavaScript, so GBP claim status usually can't be checked remotely. Confirm via a live Google search (a "Claim this business" prompt means unclaimed) or by having the client log into business.google.com directly.
  • Don't report something as a confirmed gap without a second look — content lower on a page can be missed by a fetch tool. If corrected later, note the correction openly rather than quietly editing it away.

Output format

  1. A findings table (one row per item, each with a Result and a one-line Reason).
  2. A prioritized action list split into three groups: client can do directly, needs their team/web developer/brokerage (flag rather than treat as a deliverable for the individual), and technical fixes (tackled last).
  3. A sources list of every URL actually checked, noting anything attempted but not accessible.

Tone: factual and non-alarmist — this is a diagnostic, not a sales pitch.

Verification

  • Every "confirmed gap" has been checked at least twice (initial fetch + a second look) before being reported as confirmed.
  • Every checked URL appears in the sources list, including ones that were blocked or inaccessible.
  • The action list is split into the three ownership groups, not left as one flat list.
  • No fixes have been started — scope confirmation from the user/client comes first.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

PeakWorkflowSolutions/pws-portfolio

Generates client-ready contractor bids that reproduce a specific business's own template and voice exactly, changing only the job-specific content (scope, price, materials, timeline, client info). Use this skill whenever building, adapting, or troubleshooting a bid/proposal generator for a contractor business, whenever the user mentions "bid generator," "proposal generator," extracting a business's bid style, or onboarding a new contractor client for PWS's bid generation offer. Status: Complete (v1).

PeakWorkflowSolutions/pws-portfolio

Turns a new client's intake answers into a complete, ready-to-deploy PWS lead capture system package — Zap configs, the customized Claude prompt, Google Form fields, Sheet columns, and an owner's one-pager guide, all generated together from one intake conversation. Use this skill whenever onboarding a new client for PWS's missed-call lead capture system, whenever the user mentions "new client," "onboarding," "intake," or wants to set up the lead capture system for a specific business. This skill builds directly on top of lead-capture-skill — read that skill first if it's available, since this skill reuses its finalized prompt structure and system design.

PeakWorkflowSolutions/pws-portfolio

Scans top-performing content in a specific person's industry and local market, then builds a content playbook and tailored post ideas for lead generation. Use for Marcos's own content or any client's team/agents.

PeakWorkflowSolutions/pws-portfolio

Documents PWS's AI-Powered Missed Call Lead Capture System — an OpenPhone + Zapier + Claude + Google Forms/Sheets workflow that turns missed calls into captured leads automatically. Use this skill whenever building, adapting, explaining, or troubleshooting a missed-call lead capture system for a client, whenever the user mentions OpenPhone, Zapier lead capture, missed call automation, or a new client onboarding for PWS's flagship offer.

PeakWorkflowSolutions/pws-portfolio

Acts as Marcos's technical co-builder for a real PWS client automation project: diagnoses the client's actual problem, designs the solution and tool stack, and walks through building the workflow, scripts, or code step by step.

PeakWorkflowSolutions/pws-portfolio

Use when Marcos reports how a sales call went (in any wording, any time of day) so the lead's record in the Notion Prospects database gets updated.

PeakWorkflowSolutions/pws-portfolio

Generates branded, print-ready PWS service agreements, retainer terms, and consent/access forms from a client's real scope — one agreement per build, 20/80 payment, fillable Automation Builds table with auto-totaled price, black-and-white tables, no baked-in discount math.

PeakWorkflowSolutions/pws-portfolio

Use before Marcos's daily cold calls: pulls today's due leads from the Notion Prospects database and builds a researched, honest call script for each.

PeakWorkflowSolutions/pws-portfolio

Turns a recorded client meeting into a structured intake ready for the paperwork skill — pulls the Wispr Flow transcript, checks it against a fixed Scope/Timeline/Pricing/Payment/Access checklist, and publishes an interactive artifact so Marcos can fill in whatever the meeting didn't cover before it ends.

PeakWorkflowSolutions/pws-portfolio

Turns a new PWS video script/transcript into a ready-to-post batch of platform-specific social copy — the established priority channel set, brand voice, and per-platform formatting rules baked in.

PeakWorkflowSolutions/pws-portfolio

Runs the structured intake-to-demo pattern for a PWS website-build client: a fixed discovery questionnaire, a completeness check, and an auto-drafted first demo site built from the client's real answers with honest placeholders.

相關技能