How this Hidden “Insights” Feature Improves Claude Code

Create an empty folder and open it in your IDE. Open a new terminal session and run: `claude /insights`.

Pro tip: If this command fails, close Claude Code with `ctrl + c` and reopen it. This should update Claude Code if you needed an update to use `/insights`.

Claude should begin working on your insights report. When it’s done, it will give you a link to a file named `report.html`. Copy it into your current folder.

Start the webpage with `cmd + shift + p` and find the “Open Live Server” tool.

Pro tip: You can also give the HTML file to Claude or ChatGPT and have them run it for you.

Scroll through the report sections. Here’s some of what you’ll find:

• What You Work On shows cards for each project you’ve used Claude Code on, with session counts and a summary of what happened. It also breaks down what you asked for most, which tools Claude used, what languages you work in, and your session types.
• Impressive Things You Did highlights what went well across your sessions.
• Where Things Go Wrong helps you learn where the disconnects are between you and Claude Code. It flags patterns like Claude ignoring your instructions, producing buggy code, or taking wrong approaches.

Scroll down to “Existing CC Features to Try.” This section has copy-paste-ready lines for your `CLAUDE.md`.

Each suggestion comes with a “Copy” button and an explanation of why it matters for you specifically. For example, if Claude keeps ignoring your theme preferences, you might see a `CLAUDE.md` line like this:

This project uses TypeScript with a custom shadcn/ui dark theme. ALWAYS use the initialized theme tokens instead of arbitrary Tailwind color classes.

Open your `CLAUDE.md` in any project, paste in the suggestions you want, and Claude will follow them in future sessions.

The report also suggests Custom Skills and Hooks based on your patterns.

Custom skills are reusable prompts you trigger with a single command. If you keep doing the same task over and over, such as generating `CLAUDE.md` files for new repos, the report will suggest turning that into a skill so it runs with one command instead of a full session.

To set one up, paste the skill code from the report into Claude Code and say:

Set up this skill

Claude creates it for you. You can then use it anytime with a custom slash command in Claude Code.

Pro tip: To use newly installed skills, exit and restart Claude Code.