feat(docs): show per-skill pages in the left sidebar (#26646)

Individual skill pages (e.g. /docs/user-guide/skills/bundled/productivity/notion)
had no sidebar rendered — the sidebar config only listed the two catalog index
pages. That was an intentional choice from an earlier 'too many entries would
drown product docs' concern, but the effect is that a user landing on any skill
page (via search, share link, or the catalog table) loses navigation entirely
and can't see related skills.

Wire build_sidebar_items() (which was already computed and discarded) back into
the sidebar. Structure:

  Skills
  ├── Bundled skills catalog       (catalog table, was already there)
  ├── Optional skills catalog      (catalog table, was already there)
  ├── Bundled
  │   ├── apple/
  │   │   ├── apple-apple-notes
  │   │   └── ...
  │   └── ... (one collapsed category per skill category)
  └── Optional
      └── ... (same)

Categories are collapsed by default so the top-level Skills entry doesn't
explode visually. Users browsing one skill see siblings in the same category;
the catalogs remain the at-a-glance entry point.

Also includes drift the regen script naturally produces on top of current main:
- creative-comfyui v5.0.0 → v5.1.0 page (author + new ref file)
- devops-kanban-worker SKILL.md updates
- new pages for optional skills that lacked generated docs:
  hyperliquid, finance-stocks, software-development/rest-graphql-debug
- updated optional-skills-catalog row for those

Validation:
- npx docusaurus build (en locale) succeeded — only pre-existing warnings
- inspected built productivity-notion/index.html: sidebar tree present,
  sibling productivity skills (airtable, linear, etc.) all linked
This commit is contained in:
Teknium 2026-05-15 17:04:30 -07:00 committed by GitHub
parent cd9470f416
commit dc4cde278b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
8 changed files with 1411 additions and 33 deletions

View file

@ -113,6 +113,444 @@ const sidebars: SidebarsConfig = {
items: [
'reference/skills-catalog',
'reference/optional-skills-catalog',
{
type: 'category',
label: 'Bundled',
collapsed: true,
items: [
{
type: 'category',
label: 'apple',
collapsed: true,
items: [
'user-guide/skills/bundled/apple/apple-apple-notes',
'user-guide/skills/bundled/apple/apple-apple-reminders',
'user-guide/skills/bundled/apple/apple-findmy',
'user-guide/skills/bundled/apple/apple-imessage',
'user-guide/skills/bundled/apple/apple-macos-computer-use',
],
},
{
type: 'category',
label: 'autonomous-ai-agents',
collapsed: true,
items: [
'user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-claude-code',
'user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-codex',
'user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-hermes-agent',
'user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-opencode',
],
},
{
type: 'category',
label: 'creative',
collapsed: true,
items: [
'user-guide/skills/bundled/creative/creative-architecture-diagram',
'user-guide/skills/bundled/creative/creative-ascii-art',
'user-guide/skills/bundled/creative/creative-ascii-video',
'user-guide/skills/bundled/creative/creative-baoyu-comic',
'user-guide/skills/bundled/creative/creative-baoyu-infographic',
'user-guide/skills/bundled/creative/creative-claude-design',
'user-guide/skills/bundled/creative/creative-comfyui',
'user-guide/skills/bundled/creative/creative-creative-ideation',
'user-guide/skills/bundled/creative/creative-design-md',
'user-guide/skills/bundled/creative/creative-excalidraw',
'user-guide/skills/bundled/creative/creative-humanizer',
'user-guide/skills/bundled/creative/creative-manim-video',
'user-guide/skills/bundled/creative/creative-p5js',
'user-guide/skills/bundled/creative/creative-pixel-art',
'user-guide/skills/bundled/creative/creative-popular-web-designs',
'user-guide/skills/bundled/creative/creative-pretext',
'user-guide/skills/bundled/creative/creative-sketch',
'user-guide/skills/bundled/creative/creative-songwriting-and-ai-music',
'user-guide/skills/bundled/creative/creative-touchdesigner-mcp',
],
},
{
type: 'category',
label: 'data-science',
collapsed: true,
items: [
'user-guide/skills/bundled/data-science/data-science-jupyter-live-kernel',
],
},
{
type: 'category',
label: 'devops',
collapsed: true,
items: [
'user-guide/skills/bundled/devops/devops-kanban-orchestrator',
'user-guide/skills/bundled/devops/devops-kanban-worker',
'user-guide/skills/bundled/devops/devops-webhook-subscriptions',
],
},
{
type: 'category',
label: 'dogfood',
collapsed: true,
items: [
'user-guide/skills/bundled/dogfood/dogfood-dogfood',
],
},
{
type: 'category',
label: 'email',
collapsed: true,
items: [
'user-guide/skills/bundled/email/email-himalaya',
],
},
{
type: 'category',
label: 'gaming',
collapsed: true,
items: [
'user-guide/skills/bundled/gaming/gaming-minecraft-modpack-server',
'user-guide/skills/bundled/gaming/gaming-pokemon-player',
],
},
{
type: 'category',
label: 'github',
collapsed: true,
items: [
'user-guide/skills/bundled/github/github-codebase-inspection',
'user-guide/skills/bundled/github/github-github-auth',
'user-guide/skills/bundled/github/github-github-code-review',
'user-guide/skills/bundled/github/github-github-issues',
'user-guide/skills/bundled/github/github-github-pr-workflow',
'user-guide/skills/bundled/github/github-github-repo-management',
],
},
{
type: 'category',
label: 'mcp',
collapsed: true,
items: [
'user-guide/skills/bundled/mcp/mcp-native-mcp',
],
},
{
type: 'category',
label: 'media',
collapsed: true,
items: [
'user-guide/skills/bundled/media/media-gif-search',
'user-guide/skills/bundled/media/media-heartmula',
'user-guide/skills/bundled/media/media-songsee',
'user-guide/skills/bundled/media/media-spotify',
'user-guide/skills/bundled/media/media-youtube-content',
],
},
{
type: 'category',
label: 'mlops',
collapsed: true,
items: [
'user-guide/skills/bundled/mlops/mlops-models-audiocraft',
'user-guide/skills/bundled/mlops/mlops-research-dspy',
'user-guide/skills/bundled/mlops/mlops-huggingface-hub',
'user-guide/skills/bundled/mlops/mlops-inference-llama-cpp',
'user-guide/skills/bundled/mlops/mlops-evaluation-lm-evaluation-harness',
'user-guide/skills/bundled/mlops/mlops-inference-obliteratus',
'user-guide/skills/bundled/mlops/mlops-models-segment-anything',
'user-guide/skills/bundled/mlops/mlops-inference-vllm',
'user-guide/skills/bundled/mlops/mlops-evaluation-weights-and-biases',
],
},
{
type: 'category',
label: 'note-taking',
collapsed: true,
items: [
'user-guide/skills/bundled/note-taking/note-taking-obsidian',
],
},
{
type: 'category',
label: 'productivity',
collapsed: true,
items: [
'user-guide/skills/bundled/productivity/productivity-airtable',
'user-guide/skills/bundled/productivity/productivity-google-workspace',
'user-guide/skills/bundled/productivity/productivity-linear',
'user-guide/skills/bundled/productivity/productivity-maps',
'user-guide/skills/bundled/productivity/productivity-nano-pdf',
'user-guide/skills/bundled/productivity/productivity-notion',
'user-guide/skills/bundled/productivity/productivity-ocr-and-documents',
'user-guide/skills/bundled/productivity/productivity-powerpoint',
'user-guide/skills/bundled/productivity/productivity-teams-meeting-pipeline',
],
},
{
type: 'category',
label: 'red-teaming',
collapsed: true,
items: [
'user-guide/skills/bundled/red-teaming/red-teaming-godmode',
],
},
{
type: 'category',
label: 'research',
collapsed: true,
items: [
'user-guide/skills/bundled/research/research-arxiv',
'user-guide/skills/bundled/research/research-blogwatcher',
'user-guide/skills/bundled/research/research-llm-wiki',
'user-guide/skills/bundled/research/research-polymarket',
'user-guide/skills/bundled/research/research-research-paper-writing',
],
},
{
type: 'category',
label: 'smart-home',
collapsed: true,
items: [
'user-guide/skills/bundled/smart-home/smart-home-openhue',
],
},
{
type: 'category',
label: 'social-media',
collapsed: true,
items: [
'user-guide/skills/bundled/social-media/social-media-xurl',
],
},
{
type: 'category',
label: 'software-development',
collapsed: true,
items: [
'user-guide/skills/bundled/software-development/software-development-debugging-hermes-tui-commands',
'user-guide/skills/bundled/software-development/software-development-hermes-agent-skill-authoring',
'user-guide/skills/bundled/software-development/software-development-node-inspect-debugger',
'user-guide/skills/bundled/software-development/software-development-plan',
'user-guide/skills/bundled/software-development/software-development-python-debugpy',
'user-guide/skills/bundled/software-development/software-development-requesting-code-review',
'user-guide/skills/bundled/software-development/software-development-spike',
'user-guide/skills/bundled/software-development/software-development-subagent-driven-development',
'user-guide/skills/bundled/software-development/software-development-systematic-debugging',
'user-guide/skills/bundled/software-development/software-development-test-driven-development',
'user-guide/skills/bundled/software-development/software-development-writing-plans',
],
},
{
type: 'category',
label: 'yuanbao',
collapsed: true,
items: [
'user-guide/skills/bundled/yuanbao/yuanbao-yuanbao',
],
},
],
},
{
type: 'category',
label: 'Optional',
collapsed: true,
items: [
{
type: 'category',
label: 'autonomous-ai-agents',
collapsed: true,
items: [
'user-guide/skills/optional/autonomous-ai-agents/autonomous-ai-agents-blackbox',
'user-guide/skills/optional/autonomous-ai-agents/autonomous-ai-agents-honcho',
],
},
{
type: 'category',
label: 'blockchain',
collapsed: true,
items: [
'user-guide/skills/optional/blockchain/blockchain-evm',
'user-guide/skills/optional/blockchain/blockchain-hyperliquid',
'user-guide/skills/optional/blockchain/blockchain-solana',
],
},
{
type: 'category',
label: 'communication',
collapsed: true,
items: [
'user-guide/skills/optional/communication/communication-one-three-one-rule',
],
},
{
type: 'category',
label: 'creative',
collapsed: true,
items: [
'user-guide/skills/optional/creative/creative-blender-mcp',
'user-guide/skills/optional/creative/creative-concept-diagrams',
'user-guide/skills/optional/creative/creative-hyperframes',
'user-guide/skills/optional/creative/creative-kanban-video-orchestrator',
'user-guide/skills/optional/creative/creative-meme-generation',
],
},
{
type: 'category',
label: 'devops',
collapsed: true,
items: [
'user-guide/skills/optional/devops/devops-cli',
'user-guide/skills/optional/devops/devops-docker-management',
'user-guide/skills/optional/devops/devops-watchers',
],
},
{
type: 'category',
label: 'dogfood',
collapsed: true,
items: [
'user-guide/skills/optional/dogfood/dogfood-adversarial-ux-test',
],
},
{
type: 'category',
label: 'email',
collapsed: true,
items: [
'user-guide/skills/optional/email/email-agentmail',
],
},
{
type: 'category',
label: 'finance',
collapsed: true,
items: [
'user-guide/skills/optional/finance/finance-3-statement-model',
'user-guide/skills/optional/finance/finance-comps-analysis',
'user-guide/skills/optional/finance/finance-dcf-model',
'user-guide/skills/optional/finance/finance-excel-author',
'user-guide/skills/optional/finance/finance-lbo-model',
'user-guide/skills/optional/finance/finance-merger-model',
'user-guide/skills/optional/finance/finance-pptx-author',
'user-guide/skills/optional/finance/finance-stocks',
],
},
{
type: 'category',
label: 'health',
collapsed: true,
items: [
'user-guide/skills/optional/health/health-fitness-nutrition',
'user-guide/skills/optional/health/health-neuroskill-bci',
],
},
{
type: 'category',
label: 'mcp',
collapsed: true,
items: [
'user-guide/skills/optional/mcp/mcp-fastmcp',
'user-guide/skills/optional/mcp/mcp-mcporter',
],
},
{
type: 'category',
label: 'migration',
collapsed: true,
items: [
'user-guide/skills/optional/migration/migration-openclaw-migration',
],
},
{
type: 'category',
label: 'mlops',
collapsed: true,
items: [
'user-guide/skills/optional/mlops/mlops-accelerate',
'user-guide/skills/optional/mlops/mlops-training-axolotl',
'user-guide/skills/optional/mlops/mlops-chroma',
'user-guide/skills/optional/mlops/mlops-clip',
'user-guide/skills/optional/mlops/mlops-faiss',
'user-guide/skills/optional/mlops/mlops-flash-attention',
'user-guide/skills/optional/mlops/mlops-guidance',
'user-guide/skills/optional/mlops/mlops-huggingface-tokenizers',
'user-guide/skills/optional/mlops/mlops-instructor',
'user-guide/skills/optional/mlops/mlops-lambda-labs',
'user-guide/skills/optional/mlops/mlops-llava',
'user-guide/skills/optional/mlops/mlops-modal',
'user-guide/skills/optional/mlops/mlops-nemo-curator',
'user-guide/skills/optional/mlops/mlops-inference-outlines',
'user-guide/skills/optional/mlops/mlops-peft',
'user-guide/skills/optional/mlops/mlops-pinecone',
'user-guide/skills/optional/mlops/mlops-pytorch-fsdp',
'user-guide/skills/optional/mlops/mlops-pytorch-lightning',
'user-guide/skills/optional/mlops/mlops-qdrant',
'user-guide/skills/optional/mlops/mlops-saelens',
'user-guide/skills/optional/mlops/mlops-simpo',
'user-guide/skills/optional/mlops/mlops-slime',
'user-guide/skills/optional/mlops/mlops-stable-diffusion',
'user-guide/skills/optional/mlops/mlops-tensorrt-llm',
'user-guide/skills/optional/mlops/mlops-torchtitan',
'user-guide/skills/optional/mlops/mlops-training-trl-fine-tuning',
'user-guide/skills/optional/mlops/mlops-training-unsloth',
'user-guide/skills/optional/mlops/mlops-whisper',
],
},
{
type: 'category',
label: 'productivity',
collapsed: true,
items: [
'user-guide/skills/optional/productivity/productivity-canvas',
'user-guide/skills/optional/productivity/productivity-here-now',
'user-guide/skills/optional/productivity/productivity-memento-flashcards',
'user-guide/skills/optional/productivity/productivity-shop-app',
'user-guide/skills/optional/productivity/productivity-shopify',
'user-guide/skills/optional/productivity/productivity-siyuan',
'user-guide/skills/optional/productivity/productivity-telephony',
],
},
{
type: 'category',
label: 'research',
collapsed: true,
items: [
'user-guide/skills/optional/research/research-bioinformatics',
'user-guide/skills/optional/research/research-domain-intel',
'user-guide/skills/optional/research/research-drug-discovery',
'user-guide/skills/optional/research/research-duckduckgo-search',
'user-guide/skills/optional/research/research-gitnexus-explorer',
'user-guide/skills/optional/research/research-parallel-cli',
'user-guide/skills/optional/research/research-qmd',
'user-guide/skills/optional/research/research-scrapling',
'user-guide/skills/optional/research/research-searxng-search',
],
},
{
type: 'category',
label: 'security',
collapsed: true,
items: [
'user-guide/skills/optional/security/security-1password',
'user-guide/skills/optional/security/security-oss-forensics',
'user-guide/skills/optional/security/security-sherlock',
],
},
{
type: 'category',
label: 'software-development',
collapsed: true,
items: [
'user-guide/skills/optional/software-development/software-development-rest-graphql-debug',
],
},
{
type: 'category',
label: 'web-development',
collapsed: true,
items: [
'user-guide/skills/optional/web-development/web-development-page-agent',
],
},
],
},
],
},
],