
Doc and modernize
Two related workflows for a locally-cloned codebase, in one skill
- 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.
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.
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.
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-modernizeOr copy the folder to ~/.gemini/skills/doc-and-modernize yourself.
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.
Get the folder:
git clone --depth 1 https://github.com/github/awesome-copilot.gitThen 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.
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

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


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

Instrument a webapp to send useful telemetry data to Azure App Insights
- Open source
- 41.3K GitHub stars

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

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

DOCX
SkillUse 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

XLSX
SkillUse this skill any time a spreadsheet file is the primary input or output
- 196K GitHub stars
- Files and documents

PDF
SkillUse this skill whenever the user wants to do anything with PDF files
- 196K GitHub stars
- Files and documents

Convert word to md
SkillConverts 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

Drawio
SkillGenerate draw.io diagrams as .drawio files and export to PNG/SVG/PDF with embedded XML
- Open source
- 41.3K GitHub stars
- Files and documents

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


