skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
wilbeibi/wilbeibi-skills74 installs

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-review
view source ↗

Is 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

  1. Read the diff or files. Mark every point where understanding requires information not present in the code.
  2. Categorize each gap (see "Gap categories" below).
  3. Produce findings first using the output contract below.
  4. 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 documentation list with the top 3 gaps.
  • Add Quick wins only 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.

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>