Agent skill

PR Lens

by coldteadotai in coldteadotai/pr-lens

WHAT: Draws a code change or part of a codebase as an animated architecture or data-flow diagram, on its own or in a pull request.

MITAuto-check passedDevelopment

Install PR Lens

skills CLI
$ npx skills add coldteadotai/pr-lens --skill pr-lens -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install coldteadotai/pr-lens pr-lens --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/coldteadotai/pr-lens.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pr-lens .claude/skills/pr-lens && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pr-lens
GitHub stars
1.9k
Token cost
~398 tokens
SKILL.md length
160 words
Files
2
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

WHAT: Draws a code change or part of a codebase as an animated architecture or data-flow diagram, on its own or in a pull request.

  • Tasks that involve Diagrams
  • SKILL.md covers Start here and Why PR Lens
  • Calls npx
  • Tasks that involve Pull requests

What it does

PR Lens is an agent skill from coldteadotai/pr-lens. WHAT: Draws a code change or part of a codebase as an animated architecture or data-flow diagram, on its own or in a pull request. WHEN: asked to diagram, visualise or explain a change or a system, or when a pull request should carry a diagram. KEYWORDS: PR Lens, diagram, architecture, data flow, visualise, visualize, pull request

Its SKILL.md is about 400 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

It sits in Development, covering Diagrams and Pull requests. It works with Mermaid. The repository describes itself as: Review code 100X faster. Lens draws every PR as animated architecture and data-flow walkthroughs, inside the pull request itself. Use it as a GitHub App, GitHub Action, CLI, or a…. The licence is MIT.

When your agent uses it

  • Tasks that involve Diagrams
  • Tasks that involve Pull requests

Example prompts

  • “/pr-lens”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 7a9115c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

PR Lens loads about 398 tokens when it runs. Until then it costs about 85 tokens; SKILL.md has 160 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~85
When it runs · the whole SKILL.md, loaded when a task matches
~398

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from coldteadotai/pr-lens at commit 7a9115c, republished under its MIT licence (© coldteadotai). 160 words, ~398 tokens.

Download SKILL.mdSave it as .claude/skills/pr-lens/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
pr-lens
description
WHAT: Draws a code change or part of a codebase as an animated architecture or data-flow diagram, on its own or in a pull request. WHEN: asked to diagram, visualise or explain a change or a system, or when a pull request should carry a diagram. KEYWORDS: PR Lens, diagram, architecture, data flow, visualise, visualize, pull request

PR Lens

Animated architecture and data-flow diagrams for code changes and codebases. The agent writes one JSON document, and PR Lens draws it.

Run: npx @coldtea/pr-lens-cli@latest <command>. Nothing to install first.

Start here

This file is a discovery stub, not the usage guide. Before running any PR Lens command, load the actual workflow content from the CLI:

bash
npx @coldtea/pr-lens-cli@latest skill              # start here: write, validate, render, share
npx @coldtea/pr-lens-cli@latest skill references   # the graph document field by field, the config format, a full example

The CLI serves skill content that always matches the installed version, so instructions never go stale. The content in this stub cannot change between releases, which is why it just points at skill.

Why PR Lens

  • Works with any coding agent (Claude Code, Codex, Gemini CLI, Cursor, OpenCode, Copilot)
  • Draws one self-contained animated SVG that GitHub shows in a comment, with no scripts
  • validate names the exact field that is wrong, so the agent can fix its own document
  • Opens as a live canvas you can step through and ask questions on
  • Needs no model key when the agent writes the document itself

© coldteadotai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/pr-lens of coldteadotai/pr-lens.

  • SKILL.md
  • LICENSE

Open the folder on GitHubat commit 7a9115c

Compare with similar skills

PR Lens next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

PR Lens compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PR Lens this skillcoldteadotai/pr-lens1.9k—~398Automated safety check: PassMIT
PR Descriptiondxos/dxos525—~1.7kAutomated safety check: PassCustom licence
Archify Diagramstt-a1i/archify81k—~2.9kAutomated safety check: PassMIT
Diagram Designcathrynlavery/diagram-design47k1 repos~7.5kAutomated safety check: PassMIT
Draw.io Diagram StudioAgents365-ai/drawio-skill10k—~2.4kAutomated safety check: NotesMIT
Visual Reviewai-dynamo/dynamo8.3k—~4.5kAutomated safety check: PassApache-2.0

Similar skills

  • Write or rewrite a pull request description from literal section templates — summary and safety (always), bugfix, architecture, and UI — so every PR body has the same headings, tables and line…

    525 GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed
  • Archify Diagrams

    tt-a1i/archify

    Creates interactive architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone HTML with inline SVG, themes and image or video export.

    81k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Diagram Design

    cathrynlavery/diagram-design

    Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.

    47k GitHub starsUsed in 1 repo~7.5k tokens
    DevelopmentAuto-check passed
  • Draw.io Diagram Studio

    Agents365-ai/drawio-skill

    Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.

    10k GitHub stars~2.4k tokensUpdated 7 days ago
    DevelopmentAuto-check: notes
  • Visual Review

    ai-dynamo/dynamo

    Create self-contained interactive HTML code-review dashboards from GitHub or GitLab pull requests, checked-out branch diffs, or supplied unified diffs, with correctness and safe-to-merge scores…

    8.3k GitHub stars~4.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Pretty Mermaid Renderer

    imxv/Pretty-mermaid-skills

    Writes and renders Mermaid diagrams as themed SVG, PNG or terminal ASCII and Unicode art with a bundled Node.js CLI that needs no browser.

    1.5k GitHub stars~2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

More from coldteadotai/pr-lens

  • Eli5

    coldteadotai/pr-lens

    WHAT: Explains a codebase, a folder, a feature, a command or a pull request to someone who knows nothing about it, as a PR Lens canvas whose walkthrough builds the picture one part at a time.

    1.9k GitHub stars~2.3k tokensUpdated 5 days ago
    Auto-check passed

Works with

Categories

Questions about PR Lens

What does PR Lens do?

WHAT: Draws a code change or part of a codebase as an animated architecture or data-flow diagram, on its own or in a pull request. PR Lens is an agent skill from coldteadotai/pr-lens. WHAT: Draws a code change or part of a codebase as an animated architecture or data-flow diagram, on its own or in a pull request.

When should I use PR Lens?

PR Lens fits situations like: tasks that involve Diagrams; tasks that involve Pull requests.

How do I install PR Lens in Claude Code?

Run `npx skills add coldteadotai/pr-lens --skill pr-lens -a claude-code`. Or copy the skill folder (skills/pr-lens in coldteadotai/pr-lens) into .claude/skills/pr-lens in your project. Claude Code loads it when a task matches its description.

How do I install PR Lens in Codex?

Run `npx skills add coldteadotai/pr-lens --skill pr-lens -a codex`. Or copy the skill folder (skills/pr-lens in coldteadotai/pr-lens) into .agents/skills/pr-lens in your project. Codex loads it when a task matches its description.

Can I use PR Lens in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add coldteadotai/pr-lens --skill pr-lens -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pr-lens, .gemini/skills/pr-lens, .github/skills/pr-lens and .opencode/skills/pr-lens in your project.

What does PR Lens need to run?

Going by SKILL.md and its folder, PR Lens needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does PR Lens access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is PR Lens safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does PR Lens use?

PR Lens is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does PR Lens use?

About 398 tokens (SKILL.md is roughly 1.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to PR Lens?

Skills that share tags, products or a category with PR Lens: PR Description (dxos/dxos, 525 stars), Archify Diagrams (tt-a1i/archify, 81k stars), Diagram Design (cathrynlavery/diagram-design, 47k stars) and Draw.io Diagram Studio (Agents365-ai/drawio-skill, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PR Lens?

coldteadotai (a GitHub organization) maintains it in coldteadotai/pr-lens, which has 1,877 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 4, 2026.

Source: coldteadotai/pr-lens on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.