Update Docs

Update Docs ist ein offizieller Skill aus dem Next.js-Repository von Vercel. Laut Anbieter hilft er dabei, Dokumentationsbedarf aus Änderungen im aktiven Next.js-Zweig abzuleiten, passende Dokumentationsseiten zu finden und die Aktualisierung von Markdown- und MDX-Dateien strukturiert vorzubereiten. Der zunächst angegebene Pfad .claude/skills/update-docs ist im aktuellen canary-Zweig nicht als eigenständiger Ordner erreichbar, weil .claude/skills auf .agents/skills verweist. Die verifizierte Primärquelle liegt deshalb unter .agents/skills/update-docs. Der Skill ist eine Arbeitsanweisung für kompatible Coding-Agenten, kein eigenständiges Dokumentationssystem, kein Next.js-Compiler und keine Garantie, dass eine Änderung fachlich vollständig oder korrekt ist.

Zweck und Auslöser

Die Anleitung richtet sich an Situationen, in denen ein Pull Request oder eine lokale Änderung möglicherweise Dokumentation beeinflusst. Typische Auslöser sind die Bitte, Dokumentation für Änderungen zu aktualisieren, zu prüfen, welche Seiten zu einem Pull Request gehören, Dokumentation mit dem Code abzugleichen, neue Dokumentation zu einem Feature zu erstellen oder die Vollständigkeit vorhandener Texte zu bewerten. Der Arbeitsablauf beginnt mit einer Übersicht der Branch-Änderungen. Danach ordnet der Agent betroffene Quellpfade wahrscheinlichen Dokumentationsbereichen zu. Komponenten, Serverfunktionen, Build-Code, gemeinsam genutzte Bibliotheken und Konfigurationsänderungen führen dabei zu unterschiedlichen Dokumentationsarten.

Zuordnung von Code und Dokumentation

Ein wesentlicher Nutzen des Skills ist die Verbindung zwischen Quellcode und Dokumentationsstruktur. Die mitgelieferte Referenz nennt Zuordnungen für Client-Komponenten, Serverfunktionen, Konfiguration, Dateikonventionen, Direktiven, Metadaten und CLI-Befehle. Eine Änderung an einer öffentlichen Funktion soll in der API-Referenz gesucht werden, während neue Konzepte eher in einen Guide gehören. Vor einer Bearbeitung soll der Agent bestehende Seiten lesen, ihre Frontmatter und Gliederung verstehen und nach gemeinsam genutzten Inhalten für App Router und Pages Router suchen. Wenn eine Pages-Seite über ein source-Feld auf die App-Seite verweist, soll der gemeinsame Ursprung geändert werden, damit keine widersprüchlichen Kopien entstehen.

Schreib- und Prüfkonventionen

Laut Anbieter benötigen MDX-Seiten Frontmatter mit title und description. Die Anleitung beschreibt kebab-case für neue Dateinamen, passende Verzeichnisse für Komponenten, Funktionen, Konfiguration, Guides und Dateikonventionen sowie related-Links für nächste Schritte. TypeScript-Beispiele stehen vor JavaScript-Varianten und verwenden die vorgesehene switcher-Struktur. Router-spezifische Inhalte werden mit AppOnly oder PagesOnly getrennt. Ein Agent soll außerdem die offiziellen Next.js-Konventionen respektieren, bestehende Texte nicht unnötig duplizieren und die Dokumentationsformatierung mit dem im Repository vorgesehenen Linting prüfen. Die Entscheidung, welche inhaltliche Aussage eine API erklärt, bleibt eine redaktionelle und technische Prüfung.

Grenzen und Sicherheit

Der Skill kann Dokumentationsänderungen vorbereiten, aber er ersetzt weder Code-Review noch Maintainerwissen. Ein Mapping ist eine begründete Spur und kein Beweis, dass jede betroffene Seite gefunden wurde. Die Anleitung verlangt Nutzerbestätigung vor einzelnen Änderungen. Das schützt vor ungewollten Bearbeitungen, beseitigt aber nicht das Risiko falscher Schlussfolgerungen, veralteter Beispiele oder unbeabsichtigter Änderungen in gemeinsam genutzten Dateien. Ein Agent kann beim Lesen von Quellcode, Logs, Konfigurationen und MDX-Inhalten vertrauliche Informationen sehen. Tokens, Zugangsdaten, private Umgebungswerte und interne Inhalte gehören nicht in Skilltexte, Prompts oder Commit-Historien. Lokale Bearbeitung bedeutet nicht automatisch, dass Inhalte außerhalb der ausgewählten Agenten- und Modellumgebung bleiben.

Einordnung und Quellenlage

Die offizielle Next.js-Dokumentation erklärt die Beiträge zur Dokumentation und die Vercel-Dokumentation beschreibt Next.js auf der Vercel-Plattform. Diese Quellen ergänzen die konkrete Skill-Datei, ersetzen sie aber nicht als Beschreibung des Arbeitsablaufs. Das Next.js-Repository nennt die MIT-Lizenz. Der Eintrag behauptet nicht, dass der Skill jede Next.js-Version, jede Dokumentationsstruktur oder jeden externen Agenten automatisch unterstützt. Teams sollten Branch, Quellpfade, Frontmatter, Beispiele und veröffentlichte Seiten vor dem Merge gegen den aktuellen Repository-Stand prüfen. Aktuelle Anbieterbedingungen und Funktionsumfänge sind direkt bei Vercel und Next.js zu prüfen; konkrete Preise nennt dieser Eintrag nicht.