docs-to-fern

name	docs-to-fern
description	Migrate a plain Markdown docs/ folder to a Fern documentation site from scratch. Use this skill when a project has no existing publishing framework and needs to scaffold Fern config, migrate content, and build navigation.

Docs to Fern Migration

Migrate a plain Markdown docs/ folder to a fully functional Fern documentation site. This skill covers everything from scaffolding the Fern project to publishing.

Assumes:

• Source is plain Markdown files (no Sphinx, no RST)
• No existing Fern setup in the repo
• NVIDIA branding (colors, logos, SPDX headers)

For Sphinx-to-Fern migrations, see the fern-migration skill instead.

---

Phase 0: Discover and Inventory

Before migrating, analyze the current docs/ folder.

Step 0.1: Inventory Source Files

# Count Markdown files
find docs -type f -name "*.md" | wc -l

# List all files
find docs -type f -name "*.md" | sort

# List top-level folders
ls -d docs/*/

# Find all images
find docs -type f \( -name "*.png" -o -name "*.jpg" -o -name "*.svg" -o -name "*.gif" \) | sort