Skip to content
Skill

Doc and modernize

Two related workflows for a locally-cloned codebase, in one skill

Install
Scripts
None
Platforms
Claude Code, Codex, Cursor
GitHub stars
41.3K
Last commit
1 day ago
License
MIT
Listing updated
today

When your agent uses it

Two related workflows for a locally-cloned codebase, in one skill. Documentation mode produces a single, comprehensive, verifiable architecture document primarily by reading files on disk (local-first) — use it whenever the user wants to understand, map, document, research, or onboard onto a codebase ("research this repo", "write up the architecture", "do an architecture deep dive", "document how this codebase works", "map the system design", "create an onboarding doc"). Modernization mode generates a phased plan to modernize, migrate, upgrade, or rewrite a legacy system ("modernize this", "plan the migration", "how would we rewrite this", "how do we get off this legacy stack"); if no architecture document exists yet it first runs Documentation mode, then continues straight through to the plan. It assumes the legacy stack may be dead, runs a time-boxed feasibility spike, and picks the highest achievable rung on a safety ladder instead of demanding a fully-green legacy CI gate up front.

From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.

What it can access

From a static check of its 3 files (70 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.

Install

Copy the skill folder to ~/.claude/skills/doc-and-modernize to use it in all your projects:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/doc-and-modernize &&
cp -R "$tmp/skills/doc-and-modernize" ~/.claude/skills/doc-and-modernize &&
rm -rf "$tmp"

For one project only, put the folder in .claude/skills/doc-and-modernize inside it instead.

Claude Code docs on skills

Copy the skill folder to ~/.agents/skills/doc-and-modernize to use it in every repository:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/doc-and-modernize &&
cp -R "$tmp/skills/doc-and-modernize" ~/.agents/skills/doc-and-modernize &&
rm -rf "$tmp"

For one repository only, put the folder in .agents/skills/doc-and-modernize inside it instead.

Codex docs on skills

Copy the skill folder to ~/.cursor/skills/doc-and-modernize to use it in every project:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/doc-and-modernize &&
cp -R "$tmp/skills/doc-and-modernize" ~/.cursor/skills/doc-and-modernize &&
rm -rf "$tmp"

For one project only, put the folder in .cursor/skills/doc-and-modernize inside it instead.

Cursor docs on skills

Run in a terminal (add --scope workspace to install it for the current workspace only):

gemini skills install https://github.com/github/awesome-copilot.git --path skills/doc-and-modernize

Or copy the folder to ~/.gemini/skills/doc-and-modernize yourself.

Gemini CLI docs on skills

For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/doc-and-modernize:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/doc-and-modernize &&
cp -R "$tmp/skills/doc-and-modernize" ~/.copilot/skills/doc-and-modernize &&
rm -rf "$tmp"

For one project only, put the folder in .github/skills/doc-and-modernize inside it instead.

VS Code docs on skills

Get the folder:

git clone --depth 1 https://github.com/github/awesome-copilot.git

Then copy awesome-copilot/skills/doc-and-modernize into your agent's skills folder as doc-and-modernize. Agents that support SKILL.md read one folder per skill.

The SKILL.md format

Doc and modernize FAQ

How do I install Doc and modernize in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/doc-and-modernize to use it in all your projects, or to .claude/skills/doc-and-modernize in one project.

Does Doc and modernize run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

Which AI agents can use Doc and modernize?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

What are the best alternatives to Doc and modernize?

The closest alternatives to Doc and modernize are DOCX, XLSX, PDF, Convert word to md and Drawio.

More from github/awesome-copilot

  1. Design or review infrastructure, deployment, CI/CD, Docker, Kubernetes, health checks, rollback, feature flags, production readiness, and mo

    • Open source
    • 41.3K GitHub stars
    • Cloud and infrastructure
  2. Stop coding agents from shipping generic UI

    • Open source
    • 41.3K GitHub stars
  3. Cross-references C# Web API controllers/DTOs against their TypeScript/JavaScript consumers (React, Angular, Vue, Svelte, Node.js, or hand-wr

    • Open source
    • 41.3K GitHub stars
  4. Serves as a reviewer of the codebase with instructions on looking for Apple App Store optimizations or rejection reasons.

    • Open source
    • 41.3K GitHub stars
  5. Triage and resolve Arch Linux issues with pacman, systemd, and rolling-release best practices.

    • Open source
    • 41.3K GitHub stars

Alternatives to Doc and modernize

  1. DOCX

    Skill

    Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files)

    • 196K GitHub stars
    • Files and documents
  2. XLSX

    Skill

    Use this skill any time a spreadsheet file is the primary input or output

    • 196K GitHub stars
    • Files and documents
  3. PDF

    Skill

    Use this skill whenever the user wants to do anything with PDF files

    • 196K GitHub stars
    • Files and documents
  4. Converts Word (.docx) documents into Markdown so their contents can be accurately analyzed, summarized, searched, or extracted from

    • Open source
    • 41.3K GitHub stars
    • Files and documents
  5. Drawio

    Skill

    Generate draw.io diagrams as .drawio files and export to PNG/SVG/PDF with embedded XML

    • Open source
    • 41.3K GitHub stars
    • Files and documents
  6. Export Markdown containing Mermaid code fences to Word (.docx) with embedded SVG diagrams and PNG fallbacks

    • Open source
    • 41.3K GitHub stars
    • Files and documents