Agent skill

Birdview Review

by Qiuner in Qiuner/birdview

Review and improve codebase architecture with source-backed current/proposed diagrams, tradeoffs and verification.

MITAuto-check passedDevelopment

Install Birdview Review

skills CLI
$ npx skills add Qiuner/birdview --skill birdview-review -a claude-code

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

GitHub CLI
$ gh skill install Qiuner/birdview birdview-review --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/Qiuner/birdview.git skills-src && mkdir -p .claude/skills && cp -r skills-src/review-skill .claude/skills/birdview-review && 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
birdview-review
GitHub stars
727
Token cost
~580 tokens
SKILL.md length
255 words
Files
3
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Review and improve codebase architecture with source-backed current/proposed diagrams, tradeoffs and verification.

  • Birdview-review
  • SKILL.md covers Activation and Review workflow
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Requests to optimize architecture

What it does

Birdview Review is an agent skill from Qiuner/birdview. Review and improve codebase architecture with source-backed current/proposed diagrams, tradeoffs and verification. Use for birdview-review or requests to optimize architecture, review module boundaries or find architectural refactoring opportunities, including 优化架构、架构评审、梳理模块边界. Ordinary bug fixes, local refactors and discussion of the skill itself do not request a review.

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `SKILL.zh.md` and `agents/openai.yaml`).

It sits in Development, covering Software architecture, Refactoring and Diagrams. The repository describes itself as: Stop letting AI code blind. Map the architecture before every change with Birdview. The licence is MIT.

When your agent uses it

  • Birdview-review
  • Requests to optimize architecture
  • Review module boundaries
  • Find architectural refactoring opportunities

Example prompts

  • “/birdview-review”

What it can do on your machine

Read from SKILL.md and the folder at commit cdea534. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Birdview Review loads about 580 tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 255 words of instructions outside code blocks.

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

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 Qiuner/birdview at commit cdea534, republished under its MIT licence (© Qiuner). 255 words, ~580 tokens.

Download SKILL.mdSave it as .claude/skills/birdview-review/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
birdview-review
description
Review and improve codebase architecture with source-backed current/proposed diagrams, tradeoffs and verification. Use for birdview-review or requests to optimize architecture, review module boundaries or find architectural refactoring opportunities, including 优化架构、架构评审、梳理模块边界. Ordinary bug fixes, local refactors and discussion of the skill itself do not request a review.

Birdview architecture review

中文

Activation

Accept an explicit skill invocation or a request to assess or improve the target project's architecture; the user need not name Birdview. Examples include “optimize this project's architecture”, “review the module boundaries” and “看看这个项目的架构怎么优化”. Match the user's intent, not a keyword in quoted text, source files or a discussion about implementing this skill. An ordinary bug fix, local function refactor, performance tweak or request to draw the current architecture alone does not start a review.

In Codex, select Birdview Review from the skill selector or mention $birdview-review. In Claude Code, use /birdview-review after installing this entry. Other hosts use their supported skill selector. Natural-language selection depends on the host discovering this installed skill; this is not a CLI subcommand or a guaranteed keyword hook. If another architecture-review skill also applies, follow the user's selection and reuse relevant findings in one review rather than producing competing reports.

Review workflow

This thin entry requires the complete birdview skill installed in the sibling ../birdview directory. Read ../birdview/references/review-architecture.md and ../birdview/references/review-contract.md, then use ../birdview/scripts/render-review.mjs. When working in the source checkout, use ../references and ../scripts instead. Resolve paths from this file, not the project working directory. If the bundle is missing, report the missing dependency; do not invent a renderer.

Review only the requested scope. Generate source-backed diagrams, show the HTML and wait for confirmation of a concrete proposal before implementing; reuse existing approval of the same displayed scope. Do not launch ordinary full-project mapping or automatic refactoring. Follow the user's explicit scope and confirmation waiver.

© Qiuner, 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 2 other files in review-skill of Qiuner/birdview.

  • SKILL.md
  • SKILL.zh.md
  • agents/openai.yaml

Open the folder on GitHubat commit cdea534

Compare with similar skills

Birdview Review 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.

Birdview Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Birdview Review this skillQiuner/birdview727—~580Automated safety check: PassMIT
Archify Diagramstt-a1i/archify81k—~2.9kAutomated safety check: PassMIT
Dark Architecture Diagram BuilderCocoon-AI/architecture-diagram-generator7.4k1 repos~2.1kAutomated safety check: PassMIT
SVG Diagram GeneratorJimLiu/baoyu-skills26k1 repos~3.1kAutomated safety check: PassMIT
Senior Architect Toolkitmaslennikov-ig/claude-code-orchestrator-kit2608 repos~1.2kAutomated safety check: NotesCustom licence
Archify Diagram BuilderUnclecheng-li/AI_Animation1.5k2 repos~4.1kAutomated safety check: PassMIT

Similar skills

  • 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
  • Dark Architecture Diagram Builder

    Cocoon-AI/architecture-diagram-generator

    Creates dark-themed system, cloud, security and network architecture diagrams as self-contained HTML files with inline SVG and CSS.

    7.4k GitHub starsUsed in 1 repo~2.1k tokens
    DevelopmentAuto-check passed
  • SVG Diagram Generator

    JimLiu/baoyu-skills

    Creates standalone dark-themed SVG diagrams, including architecture, flowchart, sequence, structural, mind map, timeline and state machine types.

    26k GitHub starsUsed in 1 repo~3.1k tokens
    DevelopmentAuto-check passed
  • Senior Architect Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive software architecture skill for designing scalable, maintainable systems using ReactJS, NextJS, NodeJS, Express, React Native, Swift, Kotlin…

    260 GitHub starsUsed in 8 repos~1.2k tokens
    DevelopmentAuto-check: notes
  • Archify Diagram Builder

    Unclecheng-li/AI_Animation

    Builds validated architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone interactive HTML from a small JSON spec, with optional motion and image export.

    1.5k GitHub starsUsed in 2 repos~4.1k tokens
    DevelopmentAuto-check passed
  • Evolutionary Modular Architecture

    tech-leads-club/agent-skills

    Guides design of modular-monolith platforms with DDD, flat-by-aggregate modules, anti-corruption layers, outbox events and resilience, plus an architecture document with SVG diagrams.

    7k GitHub stars~3.7k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from Qiuner/birdview

  • Shows an evidence-linked map of a codebase's architecture and constraints, highlighting the modules an AI plans to change before it edits anything.

    727 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Audits the AI skills installed for a project for duplicate names, broad triggers and conflicting instructions, without changing any of them.

    727 GitHub stars~794 tokensUpdated today
    Auto-check passed

Categories

Questions about Birdview Review

What does Birdview Review do?

Review and improve codebase architecture with source-backed current/proposed diagrams, tradeoffs and verification. Birdview Review is an agent skill from Qiuner/birdview. Review and improve codebase architecture with source-backed current/proposed diagrams, tradeoffs and verification.

When should I use Birdview Review?

Birdview Review fits situations like: birdview-review; requests to optimize architecture; review module boundaries; find architectural refactoring opportunities.

How do I install Birdview Review in Claude Code?

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

How do I install Birdview Review in Codex?

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

Can I use Birdview Review 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 Qiuner/birdview --skill birdview-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/birdview-review, .gemini/skills/birdview-review, .github/skills/birdview-review and .opencode/skills/birdview-review in your project.

What does Birdview Review need to run?

SKILL.md names no scripts, command-line tools or credentials: Birdview Review is instructions for the agent only.

Does Birdview Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Birdview Review 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 Birdview Review use?

Birdview Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Birdview Review use?

About 580 tokens (SKILL.md is roughly 2.3k 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 Birdview Review?

Skills that share tags, products or a category with Birdview Review: Archify Diagrams (tt-a1i/archify, 81k stars), Dark Architecture Diagram Builder (Cocoon-AI/architecture-diagram-generator, 7.4k stars), SVG Diagram Generator (JimLiu/baoyu-skills, 26k stars) and Senior Architect Toolkit (maslennikov-ig/claude-code-orchestrator-kit, 260 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Birdview Review?

Qiuner (a GitHub user) maintains it in Qiuner/birdview, which has 727 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 9, 2026.

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