Skip to content
Back to search

rederive

MarketplaceWorks with Claude CodeGitHub

Claude Code plugin that helps you explain code AI wrote for you, in an interview or at work.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ericjujianzou--rederive/badge.svg)](/listings/ericjujianzou--rederive)

HTML

<a href="/listings/ericjujianzou--rederive"><img src="/api/listings/ericjujianzou--rederive/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add EricJujianZou/rederive

The same command installs it in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, opencode, Windsurf, Amp, Goose and about 70 other agents. It puts the skill in every agent folder it finds in your project. Add `-g` to install it for every project instead. Then type `/rederive` in your agent.

It needs `git`, `bash` and `python3`.

<details> <summary>Other ways to install</summary>

As a Claude Code plugin:

/plugin marketplace add EricJujianZou/rederive
/plugin install rederive@rederive

By hand, clone the repo and copy `skills/rederive` into your agent's skills folder, such as `~/.claude/skills/` or `~/.agents/skills/`:

git clone https://github.com/EricJujianZou/rederive
cp -r rederive/skills/rederive ~/.agents/skills/

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "rederive",
  3. "description": "Claude Code plugin that helps you explain code AI wrote for you, in an interview or at work.",
  4. "owner": {
  5. "name": "Eric Zou",
  6. "url": "https://github.com/EricJujianZou"
  7. },
  8. "plugins": [
  9. {
  10. "name": "rederive",
  11. "source": "./",
  12. "description": "Explain code that AI wrote for you by re-deriving its design decisions yourself, one problem at a time."
  13. }
  14. ]
  15. }
README.md · README · 86 lines
  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="assets/banner-dark.png" />
  4. <img src="assets/banner-light.png" alt="rederive: learn any codebase by re-designing it yourself from first principles" width="100%" />
  5. </picture>
  6. </p>
  7. <p align="center"><b>An attempt by a frustrated developer to restore humanity's curiosity</b></p>
  8. <p align="center">
  9. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-24292f?style=flat" alt="MIT License" /></a>
  10. &nbsp;
  11. <a href="https://agentskills.io"><img src="https://img.shields.io/badge/Agent_Skills-compatible-24292f?style=flat" alt="Agent Skills compatible" /></a>
  12. &nbsp;
  13. <a href="#install"><img src="https://img.shields.io/badge/works_in-Claude_Code%2C_Codex%2C_Cursor_%2B_75_more-24292f?style=flat" alt="Works in Claude Code, Codex, Cursor and 75 more agents" /></a>
  14. </p>
  15. <p align="center"><sub><a href="#install">Install</a> · <a href="#a-session">A session</a> · <a href="#how-it-works">How it works</a> · <a href="#license">License</a></sub></p>
  16. **rederive** helps you explain code that AI wrote for you, in an interview or at work. It is a skill for coding agents that asks how you would build each part of your repo, so you re-derive its design decisions yourself from first principles. It also works on open source repos you want to learn.
  17. It only asks you questions to guide you to the right answer, and it won't explain things. We made this on purpose to aim for understanding through derivation, instead of memorizing what the agent says.
  18. ## Install
  19. ```
  20. npx skills add EricJujianZou/rederive
  21. ```
  22. The same command installs it in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, opencode, Windsurf, Amp, Goose and about 70 other agents. It puts the skill in every agent folder it finds in your project. Add `-g` to install it for every project instead. Then type `/rederive` in your agent.
  23. It needs `git`, `bash` and `python3`.
  24. <details>
  25. <summary>Other ways to install</summary>
  26. As a Claude Code plugin:
  27. ```
  28. /plugin marketplace add EricJujianZou/rederive
  29. /plugin install rederive@rederive
  30. ```
  31. By hand, clone the repo and copy `skills/rederive` into your agent's skills folder, such as `~/.claude/skills/` or `~/.agents/skills/`:
  32. ```
  33. git clone https://github.com/EricJujianZou/rederive
  34. cp -r rederive/skills/rederive ~/.agents/skills/
  35. ```
  36. </details>
  37. ## A session
  38. The start of a session on Express (an example, shortened):
  39. <p align="center">
  40. <picture>
  41. <source media="(prefers-color-scheme: dark)" srcset="assets/session-dark.png" />
  42. <img src="assets/session-light.png" alt="rederive asks how you would handle every HTTP request through one function. You suggest one big handler, then a shared auth function. It adds constraints until you describe a list of functions per route, and it tells you that you rederived a middleware chain." width="100%" />
  43. </picture>
  44. </p>
  45. ## Use
  46. ```
  47. /rederive # the repo you are in
  48. /rederive ~/code/myapp # a local repo
  49. /rederive https://github.com/expressjs/express # clones it into the current folder
  50. ```
  51. Talk to it in plain words. Tell it you're stuck, ask to skip a problem, or say you want to start over.
  52. ## How it works
  53. - **It starts from why the project exists.** On your own repo it asks you why you built it. On someone else's repo it works out the original problem and asks how you would solve it.
  54. - **A background agent maps the repo while you answer.** It reads the code, the import links between files and the commits where the design changed. It doesn't trust commit messages, so repos built with AI in a few big commits work too.
  55. - **The map holds 5 to 10 problems** in the order the system would be built, each with its constraints and the real design. It lives in `.rederive/map.md`. Don't open it until you're done, because it has the answers.
  56. - **When you're stuck,** it narrows the problem to a few approaches to choose from. After two wrong answers in a row it offers to sketch the problem for you.
  57. - **It keeps notes on how you did** in `.rederive/log.md`: where you struggled and what you worked out alone. Read it at the end to see what to practice.
  58. Everything stays on your machine. `.rederive/` goes in the repo's local git exclude list, so it never shows up in your commits. rederive sends no telemetry.
  59. ## License
  60. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.