@piramilan/seo-expert 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,39 @@ All notable changes to the SEO Expert skill are documented here.
 
 This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] — 2026-05-14
+
+Cleanup release. The skill's value is its playbooks and the output contract — not how those playbooks were authored. This release removes references to the training corpus from every client-facing surface so the package presents as a polished, hand-written consultant skill.
+
+### Removed
+- `sources/video-index.md` — public source-video metadata index removed from the published package.
+- `core/video-derived-lessons.md` — auto-generated topic bullets removed from the published package.
+- The `sources/` directory is no longer part of the npm tarball or repo.
+
+### Changed
+- **Output Contract item 6** rephrased: *"Source references when drawing from the video-derived corpus"* → *"Source references when citing claims, statistics, definitions, or third-party content."* The contract stays six parts; the trigger is now generic.
+- **`SKILL.md`** description trimmed to *"built on a set of hand-written, regularly maintained playbooks that compress senior SEO consulting practice into a portable, auditable skill."*
+- **Guardrails** consolidated: a single "No third-party content reproduction" rule replaces the prior "no raw transcripts" wording across `SKILL.md` and every adapter.
+- **README + INSTALL upload checklists** trimmed from 9 files to 7 (removed the two video files from Claude Project / ChatGPT / Perplexity Space upload instructions).
+- **`bin/seo-expert.js`** — `install claude-code` no longer copies `sources/` into `~/.claude/skills/seo-expert/`.
+- **`package.json`** — `files` whitelist no longer includes `sources/`.
+- **`.github/workflows/verify.yml`** — required-file check no longer requires the two removed files.
+- **`.github/PULL_REQUEST_TEMPLATE.md`** — Output Contract checklist and anti-patterns reworded to remove transcript-specific language.
+
+### Unchanged
+- The five `core/*.md` playbooks (`ai-seo-operating-system`, `technical-seo`, `content-strategy`, `local-seo`, `programmatic-seo`) — same guidance, same depth.
+- The nine prompt templates in `prompts/universal-ai-seo-prompts.md`.
+- The five adapters' install flows, principles, and output contracts.
+- The CLI commands and behavior (`install`, `copy`, `list`, `info`, `help`).
+- License (MIT), Node ≥ 18 requirement, scoped name `@piramilan/seo-expert`.
+
+### Migration
+- **`npx` users:** the next `npx @piramilan/seo-expert install <tool>` automatically pulls 0.3.0.
+- **Manual installers:** drop the two files from your knowledge bases (Claude Project, ChatGPT GPT, Perplexity Space). Re-paste the updated adapter block where the Output Contract wording matters to you.
+- **Pinned users:** `npx @piramilan/seo-expert@0.2.0 install <tool>` still works.
+
+[0.3.0]: https://github.com/Piramilan/seo-expert/releases/tag/v0.3.0
+
 ## [0.2.0] — 2026-05-13
 
 One-line install via `npx`. Same skill content as 0.1.0; new way to deliver it.

package/INSTALL.md

@@ -80,9 +80,7 @@ audit https://example.com for AI visibility
    - `core/content-strategy.md`
    - `core/local-seo.md`
    - `core/programmatic-seo.md`
-   - `core/video-derived-lessons.md`
    - `prompts/universal-ai-seo-prompts.md`
-   - `sources/video-index.md`
 5. Save.
 
 **Test it:** `Audit https://example.com for SEO`
@@ -100,7 +98,7 @@ audit https://example.com for AI visibility
    - `Rewrite this page section for AI extractability: `
    - `Build a content brief for the query: `
    - `Plan programmatic pages for the pattern: `
-6. **Knowledge** — upload the same 9 files listed in the Claude Project section above
+6. **Knowledge** — upload the same 7 files listed in the Claude Project section above
 7. **Capabilities** — enable Web Browsing (lets the GPT fetch URLs you give it). Enable Code Interpreter only if you want it to validate JSON-LD locally.
 8. **Save** → publish to *Only me*, *Anyone with the link*, or *Everyone* (the GPT Store).
 
@@ -109,7 +107,7 @@ audit https://example.com for AI visibility
 ### ChatGPT Project (alternative, simpler, no Custom GPT)
 1. **chatgpt.com → Projects → New Project**
 2. Paste the same instructions block into the Project's instructions
-3. Drop the same 9 files into Project files
+3. Drop the same 7 files into Project files
 4. Same conversation starters work.
 
 ---
@@ -133,9 +131,8 @@ audit https://example.com for AI visibility
 2. Open [adapters/perplexity-space-instructions.md](adapters/perplexity-space-instructions.md), copy the block under `## Instructions (paste this)` → paste into the Space's instructions
 3. Add to the Space library (Perplexity supports `.md`):
    - `SKILL.md`
-   - All 6 `core/*.md` files
+   - All 5 `core/*.md` files
    - `prompts/universal-ai-seo-prompts.md`
-   - `sources/video-index.md`
 4. Save.
 
 **Why Perplexity is special:** it does live web search and cites every claim. Use it for *current-state* audits where you want fresh evidence (rank tracking, AI-answer surface, competitor backlinks).

package/README.md

@@ -3,11 +3,11 @@
 > One portable SEO + AI-SEO/GEO skill that works the same way in **Claude**, **ChatGPT**, **Gemini**, **Perplexity**, and coding agents (**Cursor**, **Cline**, **Windsurf**, **Aider**).
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-0.2.0-green.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.3.0-green.svg)](CHANGELOG.md)
 [![npm](https://img.shields.io/badge/npm-%40piramilan%2Fseo--expert-red.svg)](https://www.npmjs.com/package/@piramilan/seo-expert)
 [![Skill](https://img.shields.io/badge/skill-seo--expert-purple.svg)](SKILL.md)
 
-A senior SEO + AI-search consultant in skill form. Diagnose before prescribing, return prioritized recommendations against a six-part output contract, and refuse fake-signal tactics. Built on hand-written playbooks plus a corpus of video-derived SEO lessons.
+A senior SEO + AI-search consultant in skill form. Diagnose before prescribing, return prioritized recommendations against a six-part output contract, and refuse fake-signal tactics. Built on a set of hand-written, regularly maintained playbooks.
 
 ---
 
@@ -57,7 +57,7 @@ Every deliverable from the skill contains, in order:
 3. **Concrete examples** — rewritten section, schema snippet, internal-link plan, or page template
 4. **Verification steps** — tool, expected timeframe, signal to watch
 5. **Risks, assumptions, dependencies**
-6. **Source references** when drawing from the video corpus
+6. **Source references** when citing claims, stats, or third-party content
 
 If a critical input is missing, the skill asks one specific question rather than guessing.
 
@@ -105,7 +105,7 @@ npx @piramilan/seo-expert help      # full CLI usage
 
 - If a target file (`.cursorrules`, `CONVENTIONS.md`, etc.) already exists, the CLI backs it up to `<file>.bak.<timestamp>` before writing.
 - Clipboard copy works on macOS (`pbcopy`), Linux (`wl-copy` / `xclip` / `xsel`), and Windows (`clip`). If none are available, the CLI writes `seo-expert-adapter.md` to the current directory so you can copy it manually.
-- Pin a specific version for reproducible setups: `npx @piramilan/seo-expert@0.2.0 install cursor`.
+- Pin a specific version for reproducible setups: `npx @piramilan/seo-expert@0.3.0 install cursor`.
 
 ---
 
@@ -138,9 +138,7 @@ Restart Claude Code (or open a new conversation). Ask any SEO question — the s
    - [core/content-strategy.md](core/content-strategy.md)
    - [core/local-seo.md](core/local-seo.md)
    - [core/programmatic-seo.md](core/programmatic-seo.md)
-   - [core/video-derived-lessons.md](core/video-derived-lessons.md)
    - [prompts/universal-ai-seo-prompts.md](prompts/universal-ai-seo-prompts.md)
-   - [sources/video-index.md](sources/video-index.md)
 4. Save.
 
 **Test it:** `Audit https://example.com for SEO`
@@ -157,7 +155,7 @@ Restart Claude Code (or open a new conversation). Ask any SEO question — the s
    - `Rewrite this page section for AI extractability: `
    - `Build a content brief for the query: `
    - `Plan programmatic pages for the pattern: `
-5. **Knowledge** — upload the same 9 files listed in the Claude Project section above.
+5. **Knowledge** — upload the same 7 files listed in the Claude Project section above.
 6. **Capabilities** — enable Web Browsing (so the GPT can fetch URLs you give it). Code Interpreter is optional.
 7. **Save** → publish to *Only me*, *Anyone with the link*, or *Everyone* (GPT Store).
 
@@ -182,7 +180,7 @@ Restart Claude Code (or open a new conversation). Ask any SEO question — the s
 
 1. **[perplexity.ai](https://perplexity.ai) → Spaces → Create a Space**.
 2. Open [adapters/perplexity-space-instructions.md](adapters/perplexity-space-instructions.md). Copy the block under **`## Instructions (paste this)`** → paste into the Space's instructions.
-3. Add the 9 files (same list as the Claude Project section) to the Space library.
+3. Add the 7 files (same list as the Claude Project section) to the Space library.
 4. Save.
 
 **Why Perplexity is special:** it does live web search and cites every claim. Use it for *current-state* audits where you want fresh evidence.
@@ -223,7 +221,7 @@ Run this prompt in any installed tool:
 
 > Diagnose, then return the six-part output contract for `https://example.com`. Skip detailed recommendations — I just want to confirm the skill is wired up.
 
-The response must contain six labeled sections: Diagnosis · Prioritized recommendations · Concrete examples · Verification steps · Risks/assumptions/dependencies · Source references. If any section is missing, the adapter wasn't fully pasted or the knowledge files weren't uploaded.
+The response must contain six labeled sections: Diagnosis · Prioritized recommendations · Concrete examples · Verification steps · Risks/assumptions/dependencies · Source references (when applicable). If any section is missing, the adapter wasn't fully pasted or the knowledge files weren't uploaded.
 
 ---
 
@@ -240,7 +238,7 @@ When a new release cuts (see [CHANGELOG.md](CHANGELOG.md)):
 Pin to a specific version for reproducible installs:
 
 ```bash
-npx @piramilan/seo-expert@0.2.0 install cursor
+npx @piramilan/seo-expert@0.3.0 install cursor
 ```
 
 ---
@@ -262,18 +260,15 @@ seo-expert/
 │   ├── technical-seo.md              ← crawl, index, schema, performance, Search Console
 │   ├── content-strategy.md           ← briefs, clusters, refresh, internal linking
 │   ├── local-seo.md                  ← GBP, map pack, reviews, location pages
-│   ├── programmatic-seo.md           ← templated page sets, validation, kill switches
-│   └── video-derived-lessons.md      ← generated lessons by topic (with source links)
+│   └── programmatic-seo.md           ← templated page sets, validation, kill switches
 ├── prompts/
 │   └── universal-ai-seo-prompts.md   ← 9 ready-to-paste prompt templates
-├── adapters/
-│   ├── claude-project-instructions.md
-│   ├── chatgpt-instructions.md
-│   ├── gemini-gem-instructions.md
-│   ├── perplexity-space-instructions.md
-│   └── coding-agent-rules.md
-└── sources/
-    └── video-index.md                ← public source-video metadata index
+└── adapters/
+    ├── claude-project-instructions.md
+    ├── chatgpt-instructions.md
+    ├── gemini-gem-instructions.md
+    ├── perplexity-space-instructions.md
+    └── coding-agent-rules.md
 ```
 
 ---
@@ -307,13 +302,13 @@ No bought reviews · no faked map-pack engagement · no link farms · no hidden
 > 3. Concrete HTML rewrites + JSON-LD blocks ready to ship
 > 4. Verification steps (Rich Results Test, Search Console, GA4 filters)
 > 5. Risks (schema-mismatch, thin pages, competitor positioning)
-> 6. Source links to the video corpus
+> 6. Source links for any cited stats or third-party content
 
 ---
 
 ## Versioning, contributing, license
 
-**Semver.** See [CHANGELOG.md](CHANGELOG.md). Pin to a tag (`v0.2.0`) or to an npm version (`@piramilan/seo-expert@0.2.0`) if you want a stable surface.
+**Semver.** See [CHANGELOG.md](CHANGELOG.md). Pin to a tag (`v0.3.0`) or to an npm version (`@piramilan/seo-expert@0.3.0`) if you want a stable surface.
 
 **Contributing.** Issues and PRs welcome. Useful contributions: new playbooks (`core/*.md`), new adapters (a new AI tool), new prompt templates (`prompts/*.md`), and edits that tighten existing guidance. Keep the six-part Output Contract intact — that's the skill's identity. See `.github/PULL_REQUEST_TEMPLATE.md` for the checklist.
 

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: seo-expert
 description: SEO and AI-SEO/GEO consultant for any AI tool or coding agent. Use when the user wants an SEO audit, content brief, page rewrite, technical-SEO fix, schema plan, local SEO plan, programmatic SEO plan, or AI-visibility strategy across ChatGPT, Perplexity, Gemini, Claude, Copilot, and Google AI Overviews. Returns prioritized, source-backed, implementation-ready recommendations.
-version: 0.1.0
+version: 0.3.0
 license: see LICENSE if present; treat content as reference material
 ---
 
@@ -9,7 +9,7 @@ license: see LICENSE if present; treat content as reference material
 
 One portable SEO + AI-SEO/GEO skill that works the same way in Claude (Code, Projects, Desktop), ChatGPT (GPTs, Projects), Gemini Gems, Perplexity Spaces, and coding agents (Cursor, Cline, Windsurf, Aider).
 
-The skill produces concrete, source-aware, implementation-ready work — not generic advice. It is built on hand-written playbooks and a public corpus of video-derived SEO lessons (Matt Diamante channel). Raw transcripts are private and never republished.
+The skill produces concrete, source-aware, implementation-ready work — not generic advice. It is built on a set of hand-written, regularly maintained playbooks that compress senior SEO consulting practice into a portable, auditable skill.
 
 ---
 
@@ -37,7 +37,7 @@ Phrases that should trigger it: "audit my site", "why am I not ranking", "fix my
 For every request, follow these six steps in order. Do not skip diagnosis.
 
 1. **Classify the task.** Map the request to one of: `audit`, `content-brief`, `page-rewrite`, `technical-fix`, `schema-plan`, `local-plan`, `programmatic-plan`, `ai-visibility`, `measurement`, `authority`.
-2. **Read the relevant playbook(s)** from `core/` (see routing table below). For video-derived guidance, also read `core/video-derived-lessons.md` and cite sources from `sources/video-index.md`.
+2. **Read the relevant playbook(s)** from `core/` (see routing table below). Open more than one when the task crosses concerns (e.g., a page rewrite touches both `ai-seo-operating-system.md` and `content-strategy.md`).
 3. **Diagnose the current state.** Target queries, existing pages, competitors, SERP features, AI answers, citations, crawl/index status. State assumptions explicitly when data is missing.
 4. **Map intent and entities.** Audience problem, primary entity, related entities, decision criteria, proof needed for trust.
 5. **Produce the deliverable** using the Output Contract below.
@@ -95,7 +95,7 @@ Every deliverable this skill produces includes, in this order:
 3. **Concrete examples**: at least one rewritten section, schema snippet, internal-link plan, or page template — not just guidance.
 4. **Verification steps**: how the user (or an agent) can confirm the change worked. Tools (Search Console, Rich Results Test, Schema Validator, GA4 filters, manual LLM prompts), expected timeframe, and the signal to watch.
 5. **Risks, assumptions, and dependencies**: what could break, what you assumed, what the user must provide for the work to proceed.
-6. **Source references** when drawing from the video-derived corpus (`sources/video-index.md` link + 1-line lesson).
+6. **Source references** when citing statistics, definitions, or third-party content — link the source and summarize the claim in one line.
 
 Do not return generic SEO checklists. Do not pad with definitions the user did not ask for. If you cannot complete a section because a critical input is missing, say so and ask one specific question.
 
@@ -103,8 +103,8 @@ Do not return generic SEO checklists. Do not pad with definitions the user did n
 
 ## Guardrails
 
-- **No raw transcripts.** Do not read or republish files under `private/`. Cite video sources via their YouTube URL in `sources/video-index.md` and summarize the lesson.
-- **No legal, medical, or financial advice.** The video-derived corpus is operational SEO guidance, not regulated-domain advice.
+- **No legal, medical, or financial advice.** The playbooks are operational SEO guidance, not regulated-domain advice.
+- **No third-party content reproduction.** Summarize and link sources; do not paste long passages from copyrighted material.
 - **No fake signals.** Do not recommend buying reviews, faking map-pack engagement at scale, link farms, hidden text, doorway pages, or generated-content spam. The penalty risk is higher than the upside, and modern AI systems detect these patterns.
 - **No keyword stuffing.** Recommend extractable, useful content. Density-style advice is obsolete.
 - **Respect the entity, not the channel.** If the user runs a brand, the recommendations should strengthen the brand entity across the open web (site, Wikipedia/Wikidata where applicable, reputable directories, communities) — not just one channel.
@@ -133,11 +133,6 @@ For environments without a file system (ChatGPT GPT, Gemini Gem, Perplexity Spac
 - `SKILL.md` — this file (canonical entry point).
 - `core/*.md` — the depth playbooks. Stable, hand-written.
 - `prompts/universal-ai-seo-prompts.md` — ready-to-use prompt templates.
-- `sources/video-index.md` — public metadata index of source videos.
-- `core/video-derived-lessons.md` — generated lessons keyed by topic, with source links.
 - `adapters/*.md` — environment-specific instruction blobs.
-- `scripts/` — generators (YouTube backfill + skill-pack regeneration).
-- `data/*.jsonl` — public derived data (titles, statuses, derived notes). No raw transcripts.
-- `private/` — local-only raw transcript cache. Excluded from git. Never read or publish from here.
 
 Keep `SKILL.md` and the adapters in sync when you update guidance. The `core/*.md` files are the source of truth for depth; everything else is routing and packaging.

package/adapters/chatgpt-instructions.md

@@ -13,7 +13,7 @@ Engage on any of: SEO audit, content brief, page rewrite, technical-SEO fix, sch
 
 ### Universal flow (every task)
 1. **Classify the task** into one of the categories above.
-2. **Read the relevant knowledge file(s).** Use `SKILL.md` as the routing table. For depth, open the matching `core/*.md` playbook. For source-backed lessons, open `core/video-derived-lessons.md` and link sources from `sources/video-index.md`.
+2. **Read the relevant knowledge file(s).** Use `SKILL.md` as the routing table. For depth, open the matching `core/*.md` playbook. Open more than one when the task crosses concerns.
 3. **Diagnose before prescribing.** If you don't have a URL, query, or business detail you need, ask one targeted question or state your assumption explicitly.
 4. **Map intent and entities.** Name the primary entity, related entities, decision criteria, and proof needed for trust.
 5. **Produce the deliverable** in the Output Contract format below.
@@ -27,7 +27,7 @@ Engage on any of: SEO audit, content brief, page rewrite, technical-SEO fix, sch
 - **Separate AI visibility from traditional ranking** when both are in scope — the failure modes differ.
 - **Conversion, not vanity.** Tie every recommendation to a business outcome (calls, leads, signups, revenue), not just rankings or traffic.
 - **No fake signals.** Reject requests for bought reviews, faked map-pack engagement, link farms, hidden text, doorway pages, or generated-content spam. Recommend the durable equivalent instead.
-- **No raw transcripts.** Never reproduce content from `private/`. Cite video sources via their YouTube URL in `sources/video-index.md` and summarize the lesson.
+- **No third-party content reproduction.** Summarize and link sources; do not paste long passages from copyrighted material.
 
 ### Output Contract (every deliverable)
 1. **Diagnosis** — what you observed, what's missing, what's assumed.
@@ -35,7 +35,7 @@ Engage on any of: SEO audit, content brief, page rewrite, technical-SEO fix, sch
 3. **Concrete examples** — at least one rewritten section, schema snippet, internal-link plan, or page template.
 4. **Verification steps** — tools, expected timeframe, signal to watch.
 5. **Risks, assumptions, dependencies** — what could break, what you assumed, what the user must provide.
-6. **Source references** — when drawing from the video-derived corpus, link the source video and 1-line lesson.
+6. **Source references** — when citing statistics, definitions, or third-party content, link the source and summarize in one line.
 
 If a critical input is missing, ask one specific question rather than guessing.
 
@@ -51,11 +51,7 @@ Required:
 - `core/content-strategy.md`
 - `core/local-seo.md`
 - `core/programmatic-seo.md`
-- `core/video-derived-lessons.md`
 - `prompts/universal-ai-seo-prompts.md`
-- `sources/video-index.md`
-
-Do not upload anything from `private/`.
 
 ## Conversation starters (suggested)
 

package/adapters/claude-project-instructions.md

@@ -15,7 +15,7 @@ Engage on any of: SEO audit, content brief, page rewrite, technical-SEO fix, sch
 
 ### Universal flow (every task)
 1. **Classify the task.**
-2. **Read the relevant knowledge file(s).** `SKILL.md` is the routing table. For depth, open the matching `core/*.md` playbook. For source-backed lessons, open `core/video-derived-lessons.md` and link sources from `sources/video-index.md`.
+2. **Read the relevant knowledge file(s).** `SKILL.md` is the routing table. For depth, open the matching `core/*.md` playbook. Open more than one when the task crosses concerns.
 3. **Diagnose before prescribing.** If a needed input (URL, query, business detail) is missing, ask one targeted question or state your assumption explicitly.
 4. **Map intent and entities.**
 5. **Produce the deliverable** in the Output Contract format below.
@@ -29,7 +29,7 @@ Engage on any of: SEO audit, content brief, page rewrite, technical-SEO fix, sch
 - **Separate AI visibility from traditional ranking** when both are in scope.
 - **Conversion, not vanity** — every recommendation maps to a business outcome.
 - **No fake signals** — refuse bought reviews, faked map-pack engagement, link farms, hidden text, doorway pages, generated-content spam.
-- **No raw transcripts** — never reproduce content from `private/`. Cite YouTube URLs from `sources/video-index.md`.
+- **No third-party content reproduction** — summarize and link sources; do not paste long passages from copyrighted material.
 
 ### Output Contract (every deliverable)
 1. **Diagnosis** — what you observed, what's missing, what's assumed.
@@ -37,7 +37,7 @@ Engage on any of: SEO audit, content brief, page rewrite, technical-SEO fix, sch
 3. **Concrete examples** — at least one rewritten section, schema snippet, internal-link plan, or page template.
 4. **Verification steps** — tools, expected timeframe, signal to watch.
 5. **Risks, assumptions, dependencies.**
-6. **Source references** when drawing from the video-derived corpus.
+6. **Source references** when citing statistics, definitions, or third-party content.
 
 If a critical input is missing, ask one specific question rather than guessing.
 
@@ -53,8 +53,4 @@ Required:
 - `core/content-strategy.md`
 - `core/local-seo.md`
 - `core/programmatic-seo.md`
-- `core/video-derived-lessons.md`
 - `prompts/universal-ai-seo-prompts.md`
-- `sources/video-index.md`
-
-Do not add anything from `private/`.

package/adapters/coding-agent-rules.md

@@ -30,7 +30,7 @@ You are operating as an **SEO Expert** when the user's task touches SEO surfaces
 - **Canonical and `noindex` discipline.** Filtered, sorted, paginated, and empty-state variants must be canonical/noindex'd. Programmatic generators must ship with this logic.
 - **Internal links carry intent.** Anchor text describes the destination's intent. Boilerplate "click here" wastes the signal.
 - **No fake signals.** Do not add hidden text, doorway pages, cloaking, or scripted engagement. If asked to, refuse and recommend the durable equivalent.
-- **No raw third-party transcripts.** If the repo includes `private/transcripts/`, do not read, paste, or commit content from it.
+- **No third-party content reproduction.** Summarize and link sources; do not paste long passages from copyrighted material into commits or generated pages.
 
 ### Output Contract (when explaining a change)
 1. What you changed and why (1–3 bullets).

package/adapters/gemini-gem-instructions.md

@@ -29,7 +29,7 @@ Engage on any of: SEO audit, content brief, page rewrite, technical-SEO fix, sch
 - Separate AI visibility from traditional ranking when both are in scope.
 - Tie every recommendation to a business outcome.
 - No fake signals (no bought reviews, faked engagement, link farms, hidden text, doorway pages, content spam).
-- No reproduction of raw transcripts; cite source URLs and summarize.
+- No third-party content reproduction; summarize and link sources, do not paste long passages from copyrighted material.
 
 ### Output Contract (every deliverable)
 1. **Diagnosis** — observations, gaps, assumptions.
@@ -37,7 +37,7 @@ Engage on any of: SEO audit, content brief, page rewrite, technical-SEO fix, sch
 3. **Concrete examples** — at least one rewritten section, schema snippet, internal-link plan, or page template.
 4. **Verification steps** — tools, timeframe, signal to watch.
 5. **Risks, assumptions, dependencies.**
-6. **Source references** when drawing from the SEO video corpus (cite YouTube URLs; summarize lessons).
+6. **Source references** when citing statistics, definitions, or third-party content (link the source; summarize in one line).
 
 If a critical input is missing, ask one specific question rather than guessing.
 
@@ -53,5 +53,3 @@ Since Gems do not support attached files the same way as Custom GPTs, copy the c
 - `core/content-strategy.md`
 - `core/local-seo.md`
 - `core/programmatic-seo.md`
-
-The video-derived lessons (`core/video-derived-lessons.md`) are large — paste excerpts on demand rather than embedding wholesale.

package/adapters/perplexity-space-instructions.md

@@ -27,7 +27,7 @@ Engage on any of: SEO audit, content brief, page rewrite, technical-SEO fix, sch
 - Separate AI visibility from traditional ranking when both are in scope.
 - Tie every recommendation to a business outcome.
 - No fake signals.
-- No reproduction of raw transcripts; cite the source URL from `sources/video-index.md` and summarize the lesson.
+- No third-party content reproduction; summarize and link sources, do not paste long passages from copyrighted material.
 
 ### Output Contract (every deliverable)
 1. **Diagnosis** — with linked evidence from the web where applicable.
@@ -49,8 +49,4 @@ Required:
 - `core/content-strategy.md`
 - `core/local-seo.md`
 - `core/programmatic-seo.md`
-- `core/video-derived-lessons.md`
-- `sources/video-index.md`
 - `prompts/universal-ai-seo-prompts.md`
-
-Do not add anything from `private/`.

package/bin/seo-expert.js

@@ -72,7 +72,7 @@ const TOOLS = {
     label: 'Claude Code',
     kind: 'skill-dir',
     target: path.join(os.homedir(), '.claude', 'skills', 'seo-expert'),
-    sources: ['SKILL.md', 'core', 'prompts', 'adapters', 'sources'],
+    sources: ['SKILL.md', 'core', 'prompts', 'adapters'],
     note: 'Anthropic CLI — installs to ~/.claude/skills/seo-expert/',
   },
   'claude-project': {
@@ -82,7 +82,7 @@ const TOOLS = {
     instructions: [
       '1. Go to claude.ai → New Project',
       '2. Paste the copied text into Custom instructions',
-      '3. Upload to Project knowledge: SKILL.md, core/*.md, prompts/*.md, sources/video-index.md',
+      '3. Upload to Project knowledge: SKILL.md, all core/*.md files, and prompts/universal-ai-seo-prompts.md',
     ],
   },
   chatgpt: {

package/core/ai-seo-operating-system.md

@@ -39,7 +39,7 @@ Every AI tool using this repo should produce:
 - Specific page or content examples.
 - Verification steps.
 - Risks, assumptions, and dependencies.
-- Source references when drawing from the video-derived corpus.
+- Source references when citing statistics, definitions, or third-party content.
 
 ## Measuring AI Search Surface
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piramilan/seo-expert",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Portable SEO + AI-SEO/GEO skill for Claude, ChatGPT, Gemini, Perplexity, and coding agents (Cursor, Cline, Windsurf, Aider).",
   "keywords": [
     "seo",
@@ -42,8 +42,7 @@
     "LICENSE",
     "core/",
     "prompts/",
-    "adapters/",
-    "sources/"
+    "adapters/"
   ],
   "engines": {
     "node": ">=18.0.0"

package/core/video-derived-lessons.md

@@ -1,96 +0,0 @@
-# Video-Derived AI SEO Lessons
-
-Generated: 2026-05-13T17:10:37+00:00
-
-Use these as source-linked operating principles. They are derived notes, not transcript republication.
-
-## Topic Coverage
-
-- `general_seo`: 825 source video(s)
-- `content_strategy`: 185 source video(s)
-- `authority_signals`: 100 source video(s)
-- `conversion_seo`: 76 source video(s)
-- `ai_seo_geo`: 60 source video(s)
-- `technical_seo`: 48 source video(s)
-- `local_seo`: 43 source video(s)
-- `programmatic_seo`: 8 source video(s)
-
-## Operating Principles
-
-### AI SEO / GEO
-- Make claims easy for AI systems to extract, cite, and verify with clear entities, direct answers, and source-backed proof.
-- Recurring terms to inspect in related work: chatgpt, google, seo, https, heytony, audit, com, rank.
-- Source videos: [CduVCb9By1k](https://www.youtube.com/watch?v=CduVCb9By1k), [OH7UJFaTfko](https://www.youtube.com/watch?v=OH7UJFaTfko), [2JrcV2E7L1Y](https://www.youtube.com/watch?v=2JrcV2E7L1Y), [cNTl_x_cnS8](https://www.youtube.com/watch?v=cNTl_x_cnS8), [15CCl7Osv8Y](https://www.youtube.com/watch?v=15CCl7Osv8Y), [5nWP89AlcAc](https://www.youtube.com/watch?v=5nWP89AlcAc), [_UQeZKr136k](https://www.youtube.com/watch?v=_UQeZKr136k), [TzjELQQVIPQ](https://www.youtube.com/watch?v=TzjELQQVIPQ)
-
-### Authority Signals
-- Build visible trust through reviews, citations, backlinks, expertise, and consistent brand signals.
-- Recurring terms to inspect in related work: backlinks, https, seo, google, heytony, audit, com, free.
-- Source videos: [ukHPtXOS6rA](https://www.youtube.com/watch?v=ukHPtXOS6rA), [OH7UJFaTfko](https://www.youtube.com/watch?v=OH7UJFaTfko), [JtmoqvUmzq0](https://www.youtube.com/watch?v=JtmoqvUmzq0), [ez6ZCM5kMgY](https://www.youtube.com/watch?v=ez6ZCM5kMgY), [Sd27zXjfqTo](https://www.youtube.com/watch?v=Sd27zXjfqTo), [3rBfJagQT24](https://www.youtube.com/watch?v=3rBfJagQT24), [cNTl_x_cnS8](https://www.youtube.com/watch?v=cNTl_x_cnS8), [Zfefiqwn8Cw](https://www.youtube.com/watch?v=Zfefiqwn8Cw)
-
-### Content Strategy
-- Map content to search intent and topical authority instead of publishing isolated keyword posts.
-- Recurring terms to inspect in related work: seo, https, heytony, google, audit, content, com, contentmarketing.
-- Source videos: [CduVCb9By1k](https://www.youtube.com/watch?v=CduVCb9By1k), [OH7UJFaTfko](https://www.youtube.com/watch?v=OH7UJFaTfko), [JtmoqvUmzq0](https://www.youtube.com/watch?v=JtmoqvUmzq0), [2JrcV2E7L1Y](https://www.youtube.com/watch?v=2JrcV2E7L1Y), [ez6ZCM5kMgY](https://www.youtube.com/watch?v=ez6ZCM5kMgY), [1sJ3pgnTdso](https://www.youtube.com/watch?v=1sJ3pgnTdso), [cNTl_x_cnS8](https://www.youtube.com/watch?v=cNTl_x_cnS8), [15CCl7Osv8Y](https://www.youtube.com/watch?v=15CCl7Osv8Y)
-
-### Conversion SEO
-- Measure SEO by qualified leads and revenue outcomes, not only rankings or traffic.
-- Recurring terms to inspect in related work: seo, google, https, heytony, audit, com, business, customers.
-- Source videos: [CduVCb9By1k](https://www.youtube.com/watch?v=CduVCb9By1k), [Jj_S37QBYtU](https://www.youtube.com/watch?v=Jj_S37QBYtU), [OH7UJFaTfko](https://www.youtube.com/watch?v=OH7UJFaTfko), [ez6ZCM5kMgY](https://www.youtube.com/watch?v=ez6ZCM5kMgY), [Sd27zXjfqTo](https://www.youtube.com/watch?v=Sd27zXjfqTo), [1sJ3pgnTdso](https://www.youtube.com/watch?v=1sJ3pgnTdso), [3rBfJagQT24](https://www.youtube.com/watch?v=3rBfJagQT24), [cNTl_x_cnS8](https://www.youtube.com/watch?v=cNTl_x_cnS8)
-
-### General SEO
-- Turn each SEO recommendation into a concrete page, content, or technical change that can be verified.
-- Recurring terms to inspect in related work: seo, google, rank, website, don, free, business, doing.
-- Source videos: [LcusOQdYsk4](https://www.youtube.com/watch?v=LcusOQdYsk4), [Z2M2wTvSACc](https://www.youtube.com/watch?v=Z2M2wTvSACc), [GQjfS6m1noc](https://www.youtube.com/watch?v=GQjfS6m1noc), [4PhZ0j9XyZU](https://www.youtube.com/watch?v=4PhZ0j9XyZU), [XSxU3U9TfPg](https://www.youtube.com/watch?v=XSxU3U9TfPg), [stQP8dIzf50](https://www.youtube.com/watch?v=stQP8dIzf50), [vmFRkaIn3n4](https://www.youtube.com/watch?v=vmFRkaIn3n4), [yr8VokbcCJE](https://www.youtube.com/watch?v=yr8VokbcCJE)
-
-### Local SEO
-- Tie local SEO work to calls, reviews, service-area relevance, and Google Business Profile trust signals.
-- Recurring terms to inspect in related work: seo, heytony, google, https, audit, business, com, local.
-- Source videos: [Jj_S37QBYtU](https://www.youtube.com/watch?v=Jj_S37QBYtU), [ez6ZCM5kMgY](https://www.youtube.com/watch?v=ez6ZCM5kMgY), [Sd27zXjfqTo](https://www.youtube.com/watch?v=Sd27zXjfqTo), [3rBfJagQT24](https://www.youtube.com/watch?v=3rBfJagQT24), [15CCl7Osv8Y](https://www.youtube.com/watch?v=15CCl7Osv8Y), [GG-uUzzkf-s](https://www.youtube.com/watch?v=GG-uUzzkf-s), [1dzTGLd5o9s](https://www.youtube.com/watch?v=1dzTGLd5o9s), [vr_LgnOq4tw](https://www.youtube.com/watch?v=vr_LgnOq4tw)
-
-### Programmatic SEO
-- Use repeatable templates only when each page has unique, useful data and a real search intent.
-- Recurring terms to inspect in related work: seo, https, business, heytony, audit, com, here, local.
-- Source videos: [RXxEWOVxmaM](https://www.youtube.com/watch?v=RXxEWOVxmaM), [Lpp5QdHFk80](https://www.youtube.com/watch?v=Lpp5QdHFk80), [UbCIxwN-nuY](https://www.youtube.com/watch?v=UbCIxwN-nuY), [opq02e3crQs](https://www.youtube.com/watch?v=opq02e3crQs), [MXMkQQp1mwc](https://www.youtube.com/watch?v=MXMkQQp1mwc), [TQy39akurjI](https://www.youtube.com/watch?v=TQy39akurjI), [nKP8gdVxYJk](https://www.youtube.com/watch?v=nKP8gdVxYJk), [7enXdUR3f80](https://www.youtube.com/watch?v=7enXdUR3f80)
-
-### Technical SEO
-- Fix crawlability, indexing, internal links, schema, and site structure before scaling content volume.
-- Recurring terms to inspect in related work: seo, google, com, https, website, heytony, audit, here.
-- Source videos: [OH7UJFaTfko](https://www.youtube.com/watch?v=OH7UJFaTfko), [2JrcV2E7L1Y](https://www.youtube.com/watch?v=2JrcV2E7L1Y), [Zfefiqwn8Cw](https://www.youtube.com/watch?v=Zfefiqwn8Cw), [x1dTCLdWs94](https://www.youtube.com/watch?v=x1dTCLdWs94), [2F-6cf-7HJQ](https://www.youtube.com/watch?v=2F-6cf-7HJQ), [mUNrRcnIn7Q](https://www.youtube.com/watch?v=mUNrRcnIn7Q), [pBAufJMSHtE](https://www.youtube.com/watch?v=pBAufJMSHtE), [vr_LgnOq4tw](https://www.youtube.com/watch?v=vr_LgnOq4tw)
-
-## Prompt Seeds
-
-- **It only took 6 months 😲**: Use the SEO lesson from 'It only took 6 months 😲' to audit a page for general seo. Return prioritized fixes, examples, and verification steps.
-- **SEO on easy mode 😲**: Use the SEO lesson from 'SEO on easy mode 😲' to audit a page for ai seo geo, content strategy, conversion seo. Return prioritized fixes, examples, and verification steps.
-- **Google loves these signals**: Use the SEO lesson from 'Google loves these signals' to audit a page for authority signals. Return prioritized fixes, examples, and verification steps.
-- **This will get your phone ringing 😲**: Use the SEO lesson from 'This will get your phone ringing 😲' to audit a page for local seo, conversion seo. Return prioritized fixes, examples, and verification steps.
-- **Their sales grew 500% 😲**: Use the SEO lesson from 'Their sales grew 500% 😲' to audit a page for ai seo geo, technical seo, content strategy, conversion seo, authority signals. Return prioritized fixes, examples, and verification steps.
-- **This is insane 🤯**: Use the SEO lesson from 'This is insane 🤯' to audit a page for content strategy, authority signals. Return prioritized fixes, examples, and verification steps.
-- **And he’s fully booked**: Use the SEO lesson from 'And he’s fully booked' to audit a page for ai seo geo, technical seo, content strategy. Return prioritized fixes, examples, and verification steps.
-- **Why Your Google Reviews Are Disappearing (And How to Stop It)**: Use the SEO lesson from 'Why Your Google Reviews Are Disappearing (And How to Stop It)' to audit a page for local seo, content strategy, conversion seo, authority signals. Return prioritized fixes, examples, and verification steps.
-- **You’re likely doing this right now…**: Use the SEO lesson from 'You’re likely doing this right now…' to audit a page for local seo, conversion seo, authority signals. Return prioritized fixes, examples, and verification steps.
-- **Forget SEO**: Use the SEO lesson from 'Forget SEO' to audit a page for content strategy, conversion seo. Return prioritized fixes, examples, and verification steps.
-- **This is BS**: Use the SEO lesson from 'This is BS' to audit a page for local seo, conversion seo, authority signals. Return prioritized fixes, examples, and verification steps.
-- **He knows NOTHING about SEO 😲**: Use the SEO lesson from 'He knows NOTHING about SEO 😲' to audit a page for ai seo geo, content strategy, conversion seo, authority signals. Return prioritized fixes, examples, and verification steps.
-- **Get More Leads From Google. 1 Hour a Week.**: Use the SEO lesson from 'Get More Leads From Google. 1 Hour a Week.' to audit a page for ai seo geo, local seo, content strategy, conversion seo. Return prioritized fixes, examples, and verification steps.
-- **SEO is a lot faster and easier than you think!**: Use the SEO lesson from 'SEO is a lot faster and easier than you think!' to audit a page for ai seo geo, content strategy. Return prioritized fixes, examples, and verification steps.
-- **Anyone can do this 😲**: Use the SEO lesson from 'Anyone can do this 😲' to audit a page for technical seo, content strategy, conversion seo, authority signals. Return prioritized fixes, examples, and verification steps.
-- **This site just broke Google 😲**: Use the SEO lesson from 'This site just broke Google 😲' to audit a page for ai seo geo, content strategy, conversion seo, authority signals. Return prioritized fixes, examples, and verification steps.
-- **FORCE Google to rank your site**: Use the SEO lesson from 'FORCE Google to rank your site' to audit a page for content strategy. Return prioritized fixes, examples, and verification steps.
-- **He promised not to get mad 🤣**: Use the SEO lesson from 'He promised not to get mad 🤣' to audit a page for content strategy, conversion seo, authority signals. Return prioritized fixes, examples, and verification steps.
-- **He knows NOTHING about SEO 🤯**: Use the SEO lesson from 'He knows NOTHING about SEO 🤯' to audit a page for ai seo geo, content strategy, conversion seo, authority signals. Return prioritized fixes, examples, and verification steps.
-- **I’m ditching ChatGPT omg**: Use the SEO lesson from 'I’m ditching ChatGPT omg' to audit a page for ai seo geo, content strategy. Return prioritized fixes, examples, and verification steps.
-- **Why is no one talking about this?**: Use the SEO lesson from 'Why is no one talking about this?' to audit a page for content strategy, authority signals. Return prioritized fixes, examples, and verification steps.
-- **The best ChatGPT prompt ever?**: Use the SEO lesson from 'The best ChatGPT prompt ever?' to audit a page for ai seo geo. Return prioritized fixes, examples, and verification steps.
-- **Do you remember this ad?**: Use the SEO lesson from 'Do you remember this ad?' to audit a page for general seo. Return prioritized fixes, examples, and verification steps.
-- **Set up ChatGPT tracking in GA4 (google analytics)**: Use the SEO lesson from 'Set up ChatGPT tracking in GA4 (google analytics)' to audit a page for ai seo geo. Return prioritized fixes, examples, and verification steps.
-- **How to submit your sitemap on google search console**: Use the SEO lesson from 'How to submit your sitemap on google search console' to audit a page for technical seo, content strategy. Return prioritized fixes, examples, and verification steps.
-- **10x your website traffic for free**: Use the SEO lesson from '10x your website traffic for free' to audit a page for technical seo, content strategy. Return prioritized fixes, examples, and verification steps.
-- **This isn’t cheating, it’s just smart.**: Use the SEO lesson from 'This isn’t cheating, it’s just smart.' to audit a page for local seo, content strategy. Return prioritized fixes, examples, and verification steps.
-- **You can’t unlearn this**: Use the SEO lesson from 'You can’t unlearn this' to audit a page for authority signals. Return prioritized fixes, examples, and verification steps.
-- **Should we be scared?**: Use the SEO lesson from 'Should we be scared?' to audit a page for conversion seo. Return prioritized fixes, examples, and verification steps.
-- **Google just DESTROYED ChatGPT**: Use the SEO lesson from 'Google just DESTROYED ChatGPT' to audit a page for ai seo geo, content strategy. Return prioritized fixes, examples, and verification steps.
-- **This works too well**: Use the SEO lesson from 'This works too well' to audit a page for general seo. Return prioritized fixes, examples, and verification steps.
-- **ChatGPT is launching ads… here’s what you need to know.**: Use the SEO lesson from 'ChatGPT is launching ads… here’s what you need to know.' to audit a page for ai seo geo. Return prioritized fixes, examples, and verification steps.
-- **Force Google to know about your site**: Use the SEO lesson from 'Force Google to know about your site' to audit a page for technical seo. Return prioritized fixes, examples, and verification steps.
-- **Canva just destroyed Photoshop**: Use the SEO lesson from 'Canva just destroyed Photoshop' to audit a page for ai seo geo, content strategy. Return prioritized fixes, examples, and verification steps.
-- **It’s kind of scary**: Use the SEO lesson from 'It’s kind of scary' to audit a page for content strategy. Return prioritized fixes, examples, and verification steps.