skills.rest
nseng-ai
nseng-aiOFFICIAL
Explore all skills by this author →
GitHub

review-improve-codebase-architecture

Runs the improve-codebase-architecture review definition against a supplied diff or current branch.

2|Updated Apr 2, 2026
Search Tags:#git#diff analysis#architecture#code review#cli#read-only#review automation
One-click install
npx skills add https://github.com/nseng-ai/ns --skill review-improve-codebase-architecture-nseng-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-improve-codebase-architecture
Source: https://github.com/nseng-ai/ns/tree/main/skills/internal/review-system/review-improve-codebase-architecture
Command: npx skills add https://github.com/nseng-ai/ns --skill review-improve-codebase-architecture-nseng-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Applying an architecture review consistently is hard when reviewers reinterpret rules from memory. This Skill invokes the canonical improve-codebase-architecture review definition so every diff or branch is evaluated against the same authoritative criteria. ## Core Features & Use Cases - Authoritative Review Definition: Reads .ns/reviews/improve-codebase-architecture/review.md and applies it exactly, without duplicating or reinterpreting the rules. - CLI Integration: Prefers the ns reviews review run improve-codebase-architecture command when running inside the ns repository. - Read-Only Findings: Keeps the review grounded strictly in the supplied diff or current branch changes, with no modifications to the codebase. - Use Case: Before merging a large refactor, run this review against the branch to surface architecture-level concerns grounded in the actual diff rather than generic advice. ## Quick Start Ask the agent to run the improve-codebase-architecture review on the current branch changes.

Frequently Asked Questions about review-improve-codebase-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an architecture review on my current branch?▼

Run `ns reviews review run improve-codebase-architecture` inside the ns repository, or invoke this Skill and let it read the review definition from `.ns/reviews/improve-codebase-architecture/review.md` and apply it to your branch changes.

What does the improve-codebase-architecture review check?▼

The checks are defined in `.ns/reviews/improve-codebase-architecture/review.md`, which is the authoritative source. The Skill reads that file and applies it exactly rather than summarizing or reinterpreting the rules.

Can this review modify my code while reviewing?▼

No. The Skill is explicitly read-only. It analyzes the supplied diff or current branch changes and reports findings grounded in the diff without making any modifications.

Does this Skill work outside the ns repository?▼

It is designed for the ns repository review system. It prefers the ns CLI when available and otherwise falls back to reading the review definition file at `.ns/reviews/improve-codebase-architecture/review.md`, which must exist.

Why does the review output differ from what I expected?▼

Findings must stay grounded in the supplied diff and follow the review.md definition exactly. If results seem off, check that the correct diff or branch was supplied and that the review definition file is current.

Related Skills

Explore More Software Engineering Skills→
edri2oredri2or

git-commit

Generate conventional git commits with enforced types and subject limits.

Official
Intermediate
FastLEDFastLED
7.5k

address-reviews

Fetch, classify, fix, and reply to CodeRabbit review comments on GitHub pull requests.

Official
Intermediate
torikhayestorikhayes

security-findings-link

Link duplicate security-review findings so consolidated reports merge them into one entry.

Community
Basic
indrasvatindrasvat
3

api-compat

Detect breaking changes in protobuf, OpenAPI, GraphQL, and Go API definitions.

Community
Advanced