Skip to content

the-senior-dev/senior-dev-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Senior Dev Skills for AI Coding Agents

A senior wizard in sunglasses — TheSeniorDev

Coding agent skills to think like a Senior Engineer.

By TheSeniorDev · MIT-licensed · Contributions welcome



Install

npx skills@latest add the-senior-dev/senior-dev-skills

Or with Claude Code's native plugin marketplace:

/plugin marketplace add the-senior-dev/senior-dev-skills
/plugin install senior-dev-skills@senior-dev-skills

Restart Claude Code (or open a new session) to pick up the new skills.

Need Claude Code? Get it at claude.com/code.

How to use in Claude Code

Invoke a skill by name, with an optional argument:

/react-senior-code-review src/features/checkout   # review a feature
/react-senior-interview state                       # quiz yourself on state & data flow

react-senior-code-review takes a path to the feature you want reviewed; react-senior-interview takes an optional topic (or none, for a broad interview).

What's inside

Skill What it does Invoke
react-senior-code-review Review React code like a Senior. /react-senior-code-review <path>
react-senior-interview Senior level React interview practice. /react-senior-interview [topic]

These skills are like having a Senior Engineer by your side, pointing out things you might have missed. They leverage Software Fundamentals, Design Patterns, and Senior Mental Models — together with the power of Claude Code — to push your code toward production readiness, prep you with real interview questions, and ground every call in deep domain knowledge and fundamentals. Keep in mind they are:

  • Highly opinionated. Biased toward what holds up in production — the wisdom a senior reviewer brings, not a neutral checklist.
  • Anti-useEffect. Reach for derived state first, then event handlers, then render-time computation. Effects are the last resort.
  • Server state ≠ client state. Server data lives in a query layer (TanStack Query, SWR, route loaders, RSC) — never in useState+useEffect, never in Zustand.
  • Push state down. State lives as close to its consumer as possible.
  • Colocate, then share. Code used by one feature stays in that feature; promote it to shared/ only when a second feature actually needs it.
  • Name the pattern. Custom hook? Compound components? HOC? Render prop? State machine? Optimistic update? If a known pattern fits the fix, it gets named.

Both skills run on the same rules catalog — one file per dimension, plus Rules of Hooks, the patterns playbook, the severity rubric, and curated docs. The canonical copy lives in skills/react-senior-code-review/references/ (indexed by principles.md); react-senior-interview carries a synced copy so each skill installs and runs independently. Edit the canonical files, then run scripts/sync-references.sh.

Roadmap

Each skill ships an authoritative knowledge catalog (a references/ folder indexed by principles.md) and a thin SKILL.md that runs the workflow. Planned additions in the same monorepo:

  • node-senior-review / node-interview
  • typescript-senior-review
  • system-design-interview

You can open an issue with the area you want next.

Contributing

The principles in skills/react-senior-code-review/references/ are the core of both skills. Pull requests are welcome — especially:

  • Sharper rule statements (less verbose).
  • New patterns (with a clear "when it makes sense / when not").
  • Better calibration for interview questions.

If you're adding a new skill, mirror the layout: SKILL.md is the workflow, a references/ folder (indexed by principles.md) is the knowledge.

License

MIT — use freely, fork freely, ship freely.


Built and battle-tested by bogdanned & dragosgn at TheSeniorDev.

About

Claude Code skills to help you think like a Senior Engineer.

Topics

Resources

License

Stars

19 stars

Watchers

1 watching

Forks

Packages

 
 
 

Contributors