Skill

Explain this codebase

Gives a newcomer a plain-English tour of a project: what it does, how it is laid out, and where to look first. Good for non-coders inheriting a site.

Free For Claude Code

How to use it

Save the file below as .claude/skills/explain-this-codebase/SKILL.md in your project.
Run it in Claude Code with /explain-this-codebase.

SKILL.md

.claude/skills/explain-this-codebase/SKILL.md

---
name: explain-this-codebase
description: Explains how a project is organised in plain English. Use when the user is new to a repository, asks what a project does, or asks where something lives.
---

Explore the project before answering: read the README, the package or dependency file, and the top-level folders.

Then reply with:

1. **What it is**: one or two sentences, no jargon.
2. **How it is laid out**: the main folders and what each one is for.
3. **How to run it**: the exact commands, if you can find them.
4. **Where to start**: three files worth reading first, and why.

Explain any technical term the first time you use it. Say so when you are unsure rather than guessing.