Skip to content

docs(mcp): skills ship with the MCP server, not the AI plugin - #22349

Merged
JakeRuth merged 1 commit into
masterfrom
jake/plugin-skills-docs
Nov 18, 2026
Merged

JakeRuth merged 1 commit into
masterfrom
jake/plugin-skills-docs

Conversation

@JakeRuth

@JakeRuth JakeRuth commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

Problem

  • Five docs pages and the MCP page components tell people to install the PostHog AI plugin to get PostHog skills.
  • feat: ship the plugin with no bundled skills ai-plugin#311 makes that plugin ship no skills. Agents load skills through the PostHog MCP server instead.
  • Three of those links point at skill files in the plugin repo, which that PR deletes.

Order of the whole change: PostHog/posthog#137210 → PostHog/ai-plugin#311 together with PostHog/context-mill#527, PostHog/posthog#135736 and #22349.

Changes

  • The pages now say that skills ship with the MCP server, and that a connected agent loads the one it needs.
  • The "Want skills too?" note on the MCP page links to the skills docs instead of the plugin repo.
  • The skills-store link points at its source in PostHog/posthog.
  • No page layout changes. Only copy and link targets change.

Do not merge before

How did you test this code?

  • Not rendered locally. The changes are copy and link targets in 10 files.
  • Checked: the new link targets exist (/docs/skills, /docs/model-context-protocol, and the skills-store folder in PostHog/posthog).

🤖 Agent context

Autonomy: Human-driven (agent-assisted)

Agent: Claude Code, Claude Opus 5.5 (changes), Claude Fable 5.2 (description)

🤖 Generated with Claude Code

The PostHog AI plugin is moving to ship no bundled skills. Agents load
skills through the MCP server instead, so docs pages and the MCP and
WebMCP components no longer tell people to install the plugin to get
skills. The skills-store link now points at its source in the posthog
monorepo.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@JakeRuth JakeRuth self-assigned this Nov 13, 2026
@github-actions github-actions Bot added the docs Improvements or additions to product documentation, "Docs" label Nov 13, 2026
@github-actions

github-actions Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Nov 16, 2026 08:23PM

Changed pages

Page Source
Agent skills for AI Observability contents/docs/ai-observability/skills.mdx
Migrating from Fivetran contents/docs/data-pipelines/migrate-off-fivetran.md
MCP contents/docs/replay-vision/mcp.mdx
Getting started with the semantic layer contents/docs/semantic-layer/start-here.mdx
Skills contents/docs/skills/index.mdx

@github-actions

Copy link
Copy Markdown
Contributor

Vale prose linter → found 0 errors, 36 warnings, 0 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/data-pipelines/migrate-off-fivetran.md — 0 errors, 23 warnings, 0 suggestions
Line Severity Message Rule
2:23 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
7:11 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
7:108 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
11:27 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
25:181 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
27:7 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
27:102 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
28:9 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
29:114 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
41:4 warning 'Step 2: Connect your Fivetran account' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
41:25 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
43:32 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
45:27 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
49:92 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
61:231 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
65:166 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
78:129 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
89:149 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
94:28 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
95:17 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
99:15 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
101:17 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
102:29 warning Use 'FiveTran' instead of 'Fivetran'. Vale.Terms
contents/docs/replay-vision/mcp.mdx — 0 errors, 2 warnings, 0 suggestions
Line Severity Message Rule
5:187 warning Use the Oxford comma before 'and' or 'or' in a list of three or more items. PostHogBase.OxfordComma
96:105 warning 'triaged' is a possible misspelling. PostHogBase.Spelling
contents/docs/semantic-layer/start-here.mdx — 0 errors, 2 warnings, 0 suggestions
Line Severity Message Rule
15:34 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
70:79 warning 'mrr' is a possible misspelling. PostHogBase.Spelling
contents/docs/skills/index.mdx — 0 errors, 5 warnings, 0 suggestions
Line Severity Message Rule
193:5 warning 'Claude Code example' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
222:4 warning 'Example: a full session' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
390:130 warning 'subdirs' is a possible misspelling. PostHogBase.Spelling
393:54 warning 'subdirs' is a possible misspelling. PostHogBase.Spelling
409:11 warning 'preload' is a possible misspelling. PostHogBase.Spelling
src/components/AgentSkillsList/README.md — 0 errors, 1 warnings, 0 suggestions
Line Severity Message Rule
19:35 warning 'shortcode' is a possible misspelling. PostHogBase.Spelling
src/components/MCPPage/README.md — 0 errors, 3 warnings, 0 suggestions
Line Severity Message Rule
1:3 warning 'MCPPage' is a possible misspelling. PostHogBase.Spelling
63:163 warning 'Cowork' is a possible misspelling. PostHogBase.Spelling
76:322 warning 'focusable' is a possible misspelling. PostHogBase.Spelling

@github-actions

github-actions Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

12.22 MiB (+0.7 KiB / +0.0%)

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint Eager size Budget Modules
✅ app 11.15 MiB (+1.1 KiB / +0.0%) report-only 1106
Largest modules in the app closure
Module Size
css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css 1023.1 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/puzzle.mjs 388.5 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js 354.8 KiB
./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules 351.4 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/basketball-coach.mjs 337.4 KiB
./node_modules/.pnpm/framer-motion@14.0.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/components/motion/proxy.mjs + 126 modules 287.2 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js 281.9 KiB
./src/components/SearchUI/index.tsx + 87 modules 273.1 KiB
./gatsby-browser.tsx + 60 modules 259.5 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/construction-1.mjs 248.5 KiB
./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules 240.2 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/construction-2.mjs 228.2 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/magnifying-glass.mjs 221.7 KiB
./src/hooks/useProduct.ts + 18 modules 166.5 KiB

Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

@JakeRuth
JakeRuth marked this pull request as ready for review November 16, 2026 20:04
@JakeRuth JakeRuth added the stamphog Request AI approval (no full review) label Nov 16, 2026
@JakeRuth
JakeRuth merged commit b044763 into master Nov 18, 2026
29 checks passed
@JakeRuth
JakeRuth deleted the jake/plugin-skills-docs branch November 18, 2026 00:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to product documentation, "Docs" stamphog Request AI approval (no full review)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants