Skip to content

docs: move skills docs to their own section - #19385

Open
andrewm4894 wants to merge 3 commits into
masterfrom
docs/move-skills-to-self-driving
Open

docs: move skills docs to their own section#19385
andrewm4894 wants to merge 3 commits into
masterfrom
docs/move-skills-to-self-driving

Conversation

@andrewm4894

@andrewm4894 andrewm4894 commented Aug 11, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

Changes

Skills is a standalone product (in-app at /skills, owned by team-self-driving, with scouts and review-hog built on it), but its docs lived under AI engineering as "Using the PostHog skills store". This PR gives skills their own docs section.

  • Move /docs/ai-engineering/skills-store → /docs/skills (its own section, surfaced in the Docs menu under Tools > More tools)
  • Retitle the page "Skills" and reframe the intro around the product (centrally stored, versioned, usable from any MCP-connected agent; every scout is a skill). The store walkthrough remains the body of the page.
  • Nav: new top-level Skills section in src/navs/index.js; removed the old entry from AI engineering. It lands in "More tools" automatically as the overflow bucket for sections not explicitly grouped in DOCS_GROUPS.
  • Redirects: new redirect for the old URL, plus repointed the two older redirects (/docs/prompt-management/skills-store, /docs/llm-analytics/skills-store) directly at /docs/skills so nothing chains.
  • Cross-links: added a Skills row to the AI features table on /docs/ai-engineering, added Skills to the self-driving overview's concepts list, and updated links in the "everything is build mode" blog post and the "writing agent skills" newsletter.

The PostHog Desktop skills page (/docs/posthog-desktop/skills) is a separate, Desktop-specific concern and is untouched.

Checklist

  • Words are spelled using American English
  • Redirect added for the moved page (plus dechained the two older ones)
  • Internal links updated to the new path

@andrewm4894
docs: move skills docs from AI engineering to self-driving
6ffd48a 
Skills is a standalone product owned by team-self-driving (in-app at
/skills, with scouts and review-hog built on it), so its docs belong
in the self-driving section rather than under AI engineering.

- Move /docs/ai-engineering/skills-store to /docs/self-driving/skills
- Retitle the page "Skills" and reframe the intro around the product
- Add redirect for the old URL; repoint the two older skills-store
  redirects directly at the new URL to avoid chains
- Move the nav entry into the self-driving section (Concepts, before
  Scouts) and drop it from AI engineering
- Add Skills row to the AI features table on /docs/ai-engineering
- Add Skills to the self-driving overview concepts list
- Update internal links in the build-mode blog post and the
  writing-agent-skills newsletter
@github-actions github-actions Bot added the docs Improvements or additions to product documentation, "Docs" label Aug 11, 2026
@github-actions

github-actions Bot commented Aug 11, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Aug 14, 2026 05:17PM

@github-actions

github-actions Bot commented Aug 11, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Vale prose linter → found 2 errors, 34 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/blog/everything-is-build-mode.md — 0 errors, 3 warnings, 0 suggestions
Line Severity Message Rule
78:5 warning '5. Fix something in production. Yes, really.' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
104:42 warning 'Cowork' is a possible misspelling. PostHogBase.Spelling
134:404 warning 'PRDs' is a possible misspelling. PostHogBase.Spelling
contents/docs/ai-engineering/index.mdx — 1 errors, 6 warnings, 0 suggestions
Line Severity Message Rule
9:47 warning 'multimodal' is a possible misspelling. PostHogBase.Spelling
9:76 warning 'productionizing' is a possible misspelling. PostHogBase.Spelling
18:215 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
28:105 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
28:124 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
32:17 warning Use 'LLMs' instead of 'llms'. Vale.Terms
54:4 warning 'Devtools' is a possible misspelling. PostHogBase.Spelling
contents/docs/self-driving/index.mdx — 0 errors, 7 warnings, 0 suggestions
Line Severity Message Rule
14:1 warning '** Code' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
14:78 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
38:188 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
65:160 warning Capitalize 'Error Tracking' for PostHog's product. Use 'Error tracking' for the general industry concept. PostHogBase.ProductNames
65:176 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
65:196 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
66:186 warning Use American English. Use 'judgment' instead of 'judgement'. PostHogBase.AmericanEnglish
contents/docs/skills/index.mdx — 0 errors, 7 warnings, 0 suggestions
Line Severity Message Rule
195:5 warning 'Claude Code example' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
224:4 warning 'Example: a full session' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
392:130 warning 'subdirs' is a possible misspelling. PostHogBase.Spelling
394:40 warning 'frontmatter' is a possible misspelling. PostHogBase.Spelling
394:159 warning 'frontmatter' is a possible misspelling. PostHogBase.Spelling
395:54 warning 'subdirs' is a possible misspelling. PostHogBase.Spelling
411:11 warning 'preload' is a possible misspelling. PostHogBase.Spelling
contents/newsletter/writing-agent-skills.md — 1 errors, 11 warnings, 0 suggestions
Line Severity Message Rule
22:255 warning Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept. PostHogBase.ProductNames
24:102 warning Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept. PostHogBase.ProductNames
71:49 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
105:23 warning 'MCPs' is a possible misspelling. PostHogBase.Spelling
105:143 warning 'hoc' is a possible misspelling. PostHogBase.Spelling
129:48 warning 'hoc' is a possible misspelling. PostHogBase.Spelling
141:313 warning 'Cowork' is a possible misspelling. PostHogBase.Spelling
141:368 warning 'Cowork' is a possible misspelling. PostHogBase.Spelling
149:132 warning Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept. PostHogBase.ProductNames
149:171 warning 'Dunham' is a possible misspelling. PostHogBase.Spelling
153:132 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
155:305 warning 'autoresearching' is a possible misspelling. PostHogBase.Spelling

@github-actions

github-actions Bot commented Aug 11, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

7.55 MiB (+0.0 KiB / +0.0%)

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

Entrypoint Eager size Budget Modules
✅ app 16.91 MiB (+0.2 KiB / +0.0%) report-only 2018
Largest modules in the app closure
Module Size
./src/data/mcp-tools.json 990.3 KiB
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 752.3 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./node_modules/.pnpm/@radix-ui+react-icons@1.3.2_react@18.3.1/node_modules/@radix-ui/react-icons/dist/react-icons.esm.js 481.4 KiB
./node_modules/.pnpm/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules 395.1 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.cjs.js 364.8 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
./src/hooks/useCustomers.tsx + 54 modules 354.5 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
./src/components/ProductComparisonTable/index.tsx + 126 modules 301.4 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.0 KiB
./node_modules/.pnpm/@posthog+brand@0.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/magnifying-glass.mjs 254.7 KiB
./node_modules/.pnpm/framer-motion@10.18.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/dom/motion.mjs + 109 modules 253.9 KiB
./node_modules/.pnpm/d3@7.9.0/node_modules/d3/src/index.js + 208 modules 247.4 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).

@andrewm4894 andrewm4894 self-assigned this Aug 11, 2026
@andrewm4894
docs: give skills their own section under Docs > More tools
ed3873f 
Skills don't fit under self-driving either — move them to their own
top-level docs section at /docs/skills, which surfaces in the Docs
taskbar menu under Tools > More tools (the overflow bucket for
sections not explicitly grouped in DOCS_GROUPS).

- Move /docs/self-driving/skills to /docs/skills (own section index)
- Add a top-level Skills section to the docs nav; drop the entry from
  the self-driving section
- Repoint all three redirects at /docs/skills
- Update internal links (AI features table, self-driving concepts
  list, blog post, newsletter)
@andrewm4894 andrewm4894 changed the title docs: move skills docs from AI engineering to self-driving docs: move skills docs to their own section Aug 11, 2026
@andrewm4894
andrewm4894 requested a review from a team as a code owner August 14, 2026 16:59
@andrewm4894
andrewm4894 enabled auto-merge (squash) August 14, 2026 16:59
@andrewm4894

andrewm4894 commented Aug 14, 2026

Copy link
Copy Markdown
Member Author

@PostHog/editors howdy - this is kinda trying to clean up a bit - skills are not part of AIO anymore - they are kinda their own thing for now. my aim here is to just put them under "Tools" for now

i think they could be part of self driving tbh - skills are context that powers self driving - but didnt want to make too big of a change - thoughts?

@andyvan-ph
andyvan-ph requested a review from a team August 14, 2026 17:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

@andrewm4894 andrewm4894

Labels

docs Improvements or additions to product documentation, "Docs"

Projects

PostHog.com planning
Status: Backlog

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@andrewm4894