newcomer-lens-review
Review code for rationale, domain terms, constraints, and assumptions missing to a newcomer, and produce a documentation backlog. Use when asked for an onboarding review, what would confuse a new hire, what a handover is missing, or which parts of a codebase need documenting first. Do NOT use to find defects (use code-review) or to build your own understanding of unfamiliar code (use grok-repo).
How do I install this agent skill?
npx skills add https://github.com/wilbeibi/wilbeibi-skills --skill newcomer-lens-reviewIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a pure instruction set for performing code reviews from the perspective of a new team member. It contains no executable code, network requests, or external dependencies.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
newcomer-lens-review
Review as a competent engineer who just joined: general engineering knowledge, but no project-specific context — design decisions, domain terms, historical constraints, team conventions.
Steps
- Read the diff or files. Mark every point where understanding requires information not present in the code.
- Categorize each gap (see "Gap categories" below).
- Produce findings first using the output contract below.
- Prioritize: top 3 gaps that most need documentation.
Context boundary
Assumed: language semantics, common algorithms, industry standard patterns. Not assumed: why this approach, project terminology, past attempts, implicit requirements, domain concepts.
Gap categories
- Design rationale — why this algorithm/data structure/pattern over the obvious alternative?
- Domain knowledge — what do project-specific terms mean? what business rules drive this?
- Historical context — what's behind the TODO/workaround? why is approach X avoided?
- System constraints — where does this timeout/limit/threshold come from? what failure modes?
Flag vs don't flag
Flag if a newcomer must:
- Guess at unstated requirements.
- Assume domain knowledge.
- Infer from tribal knowledge.
- Ask "why not the obvious alternative?"
Don't flag:
- Standard language or framework usage.
- Common industry patterns.
- Anything inferable from immediate surrounding code.
- Style preferences.
Output contract
- Lead with
Context gaps, grouped by file/component and ordered by onboarding risk. - Each finding names the category: design rationale, domain knowledge, historical context, or system constraint.
- Add a short
Critical for documentationlist with the top 3 gaps. - Add
Quick winsonly for concrete fixes such as comments, names, constants, or doc links. - End with one line on what is understandable from the code. Omit praise.
Tone
Curious colleague asking genuine questions:
- "What constraint makes X necessary here?"
- "Is Y based on measurement or estimate?"
- "I don't see why Z — what am I missing?"
Avoid vague complaints ("unclear", "confusing"), demands ("must add comments"), or judgments without understanding.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/wilbeibi/wilbeibi-skills/newcomer-lens-review">View newcomer-lens-review on skillZs</a>