Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

docusaurus-docs-builder

/docusaurus-docs-builder

Tworzy i przebudowuje witryny dokumentacji w Docusaurus, portale deweloperskie i bazy wiedzy z atrakcyjnym, wizualnym, opartym na MDX wyglądem zamiast zwykłych stron Markdown.

Repozytorium
agent-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
40
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/update.js

Co robi i kiedy

Tworzy i przebudowuje witryny dokumentacji w Docusaurus, portale deweloperskie i bazy wiedzy z atrakcyjnym, wizualnym, opartym na MDX wyglądem zamiast zwykłych stron Markdown.

Oryginalny opis (EN)

Use when creating, redesigning, rewriting, or improving a Docusaurus documentation site, docs portal, developer docs, product docs, API docs, guide site, knowledge base, or documentation landing experience, especially when the user wants engaging, attractive, polished, conversion-aware, visual, MDX-powered documentation rather than plain Markdown pages.

Jak działa

  1. Core Behavior
  2. First Pass
  3. Documentation Strategy
  4. Reference Router
  5. Visual Documentation Rules
  6. Docusaurus Defaults
  7. Generated Official Docs
  8. Completion Gate
  9. Red Flags
Sekcje z nagłówków SKILL.md, w oryginale · 107 linii, 792 słów
Podgląd SKILL.md
---
name: docusaurus-docs-builder
description: Use when creating, redesigning, rewriting, or improving a Docusaurus documentation site, docs portal, developer docs, product docs, API docs, guide site, knowledge base, or documentation landing experience, especially when the user wants engaging, attractive, polished, conversion-aware, visual, MDX-powered documentation rather than plain Markdown pages.
metadata:
  last_updated: "2026-06-11"
---

# Docusaurus Docs Builder

Build Docusaurus documentation that feels like a polished product surface and still works as serious technical documentation.

## Core Behavior

When the user asks for Docusaurus docs, the agent should create a documentation experience with strong information architecture, visual proof, attractive MDX components, runnable examples, search, and verification, even if the source material is messy or text-heavy.

## First Pass

Inspect the project before writing:

1. Existing docs site: `docusaurus.config.*`, `sidebars.*`, `docs/`, `src/pages/`, `src/components/`, `src/css/custom.css`, versioned docs, blog, API references.
2. Product surface: package metadata, README, examples, screenshots, demos, changelog, CLI/API entrypoints, install paths.
3. Audience: new user, evaluator, API consumer, contributor, enterprise buyer, operator, or internal team.
4. Primary conversion: install, sign up, copy config, run command, deploy, migrate, integrate, or understand architecture.

If there is no Docusaurus site, scaffold the smallest fitting site and explain the chosen structure.

## Documentation Strategy

Default shape:

1. **Homepage**: one clear promise, one visual proof, one primary CTA, one secondary CTA.
2. **Docs landing page**: task-oriented entry points, not a file dump.
3. **Getting started**: shortest path to first success.
4. **Guides**: outcome-based workflows.
5. **Concepts**: mental models, architecture, diagrams.
6. **Reference**: APIs, config, CLI, schemas.
7. **Examples**: realistic scenarios with copy-pastable code.
8. **Troubleshooting**: symptoms, causes, fixes.

Use progressive disclosure: quick path first, deep details later.

When the task is "scaffold docs for this project" or "set up docs like spinup-ts" — for either a new project or an existing repo that lacks real docs — start from `references/project-docs-template.md`. It supplies the full directory tree, `sidebars.ts`, `docusaurus.config.ts`, and every page as a placeholder skeleton, plus an adaptation playbook. Drop it in, then change the details to match the actual project.

## Reference Router

Read only what the task needs:

| File | When to Read |
| --- | --- |
| `references/information-architecture.md` | Site maps, sidebar design, docs taxonomy, landing pages |
| `references/project-docs-template.md` | Proven, droppable docs scaffold (tree, sidebars, page skeletons) for bootstrapping a new project or revitalizing an existing repo |
| `references/visual-mdx-patterns.md` | MDX components, cards, callouts, diagrams, code blocks, before/after sections |
| `references/copy-and-conversion.md` | Headlines, CTAs, pain-point framing, page intros, anti-wall-of-text rules |
| `references/top-docs-patterns.md` | Best attributes of elite documentation sites and how to apply them |
| `references/markdown-mdx-reference.md` | Practical Markdown/MDX syntax and Docusaurus content patterns |
| `references/docusaurus-implementation.md` | Config, sidebars, theme, styling, plugins, search, build/deploy |
| `references/quality-gate.md` | Build, links, screenshots, search, mobile, accessibility, claims |
| `references/generated/manifest.json` | Generated snapshots of current official Docusaurus docs |

## Visual Documentation Rules

- No walls of text: turn dense explanations into cards, tabs, diagrams, tables, examples, and callouts.
- Every major page needs a visible job: orient, teach, persuade, reference, troubleshoot, or convert.
- Use screenshots, terminal demos, Mermaid diagrams, architecture strips, and MDX components where they make understanding faster.
- Make navigation task-based: "Install", "Configure auth", "Deploy", "Troubleshoot webhooks" beats internal implementation names.
- Put the shortest working example above deeper explanation.
- Keep visual polish consistent with the product brand, but do not sacrifice docs usability.

## Docusaurus Defaults

- Prefer TypeScript config files when the repo already uses TypeScript.
- Use Docusaurus' built-in docs plugin/theme unless a real requirement demands custom routing.
- Use MDX for custom visual sections and reusable components.
- Use sidebars for guided reading order, not just folder mirroring.
- Use admonitions for important notes, not decoration.
- Use tabs for platform/package-manager variants.
- Use Mermaid for maintainable diagrams when possible.
- Use generated static assets under `static/img/` or repo-standard docs assets.

Check current generated docs before relying on syntax for config, plugins, MDX behavior, search, or deployment.

## Generated Official Docs

Official Docusaurus docs are snapshotted into `references/generated/` by:

```bash
node scripts/update.js
```

Use these snapshots when implementation details may have changed. The generated set should include Docusaurus installation, configuration, docs plugin, sidebars, Markdown/MDX, code blocks, admonitions, assets, styling/layout, themes, search, deployment, versioning, i18n, and plugin pages.

## Completion Gate

Before saying the docs are done:

1. Run the Docusaurus build or the closest available docs build.
2. Verify key routes, sidebar entries, internal links, images, and code blocks.
3. Confirm first-run instructions are copy-pastable and match package metadata.
4. Check the first screen of the homepage/docs landing page for promise, proof, and action.
5. Report what was verified and any browser/live-render check still needed.

## Red Flags

Stop and revise if you catch:

- "I'll just convert the README into docs pages."
- "The sidebar can mirror the folder tree."
- "The homepage can be generic for now."
- "This page needs another long explanation."
- "The code block probably works."
- "The docs build is optional."
- "Pretty cards are enough even if users cannot find the answer."
Pliki w paczce (40)
  • SKILL.md 6 KB
  • agents/openai.yaml 1 KB
  • references/copy-and-conversion.md 1 KB
  • references/docusaurus-implementation.md 2 KB
  • references/information-architecture.md 2 KB
  • references/markdown-mdx-reference.md 3 KB
  • references/project-docs-template.md 30 KB
  • references/quality-gate.md 1 KB
  • references/top-docs-patterns.md 5 KB
  • references/visual-mdx-patterns.md 2 KB
  • references/generated/README.md 2 KB
  • references/generated/configuration.md 9 KB
  • references/generated/deployment.md 45 KB
  • references/generated/docs-create-doc.md 7 KB
  • references/generated/docs-introduction.md 4 KB
  • references/generated/docs-multi-instance.md 6 KB
  • references/generated/i18n.md 7 KB
  • references/generated/installation.md 10 KB
  • references/generated/manifest.json 8 KB
  • references/generated/markdown-admonitions.md 9 KB
  • references/generated/markdown-assets.md 6 KB
  • references/generated/markdown-code-blocks.md 20 KB
  • references/generated/markdown-diagrams.md 4 KB
  • references/generated/markdown-features.md 8 KB
  • references/generated/markdown-front-matter.md 25 KB
  • references/generated/markdown-links.md 4 KB
  • references/generated/markdown-tabs.md 9 KB
  • references/generated/markdown-toc.md 16 KB
  • references/generated/mdx-plugins.md 9 KB
  • references/generated/plugin-content-blog.md 24 KB
  • references/generated/plugin-content-docs.md 25 KB
  • references/generated/plugin-content-pages.md 8 KB
  • references/generated/search.md 18 KB
  • references/generated/seo.md 10 KB
  • references/generated/sidebar.md 1 KB
  • references/generated/styling-layout.md 14 KB
  • references/generated/swizzling.md 15 KB
  • references/generated/theme-classic.md 2 KB
  • references/generated/versioning.md 15 KB
  • scripts/update.js 6 KB

Wersje

W bazie nie ma innych skilli o nazwie docusaurus-docs-builder.

Migawka bazy z 13.11.2026 · wersja paczki b7afbbea0b2f (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 96docusaurus-docs-site
    Zamienia dokumentację repozytorium w stronę Docusaurus.
  • 100docusaurus
    Buduje strony z dokumentacją w Docusaurus: konfiguracja projektu, struktura docs, wersjonowanie, strony własne, blog, wyszukiwanie Algolia, komponenty MDX i wdrożenie, także migracja z GitBook i ReadTheDocs.
  • 100docusaurus-config-setup
    Prawdopodobnie konfiguruje Docusaurus w ramach dokumentacji technicznej, na podstawie nazwy i kategorii skilla.
  • 100h4tcher-docusaurus-generator
    Generuje lub odświeża witrynę dokumentacji projektu hatch3r w Docusaurus 3 z kanonicznego korpusu repozytorium (agenci, skille, reguły, polecenia, hooki, docs) i podgląda ją.
  • 100sidecar-website
    Pisze i utrzymuje stronę dokumentacji Sidecar w Docusaurus: strony, wpisy na blogu, style, obrazy i wdrożenie.
  • 90docusaurus-config # IMPORTANT: Keep description on ONE line for Claude Code comp
    Pomaga walidować i modyfikować konfigurację Docusaurus w plikach docusaurus.config.js lub docusaurus.config.ts.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.