cto-review

Analyze git merge-base diffs and produce a ranked PLAN.md simplification plan.

2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/hamzaPixl/pixl-ai --skill cto-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cto-review
Source: https://github.com/hamzaPixl/pixl-ai/tree/main/packages/crew/skills/cto-review
Command: npx skills add https://github.com/hamzaPixl/pixl-ai --skill cto-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies and quantifies architectural and data-flow complexity in a branch diff, prioritizing algorithmic and pipeline simplifications over cosmetic changes to reduce long-term maintenance burden and runtime inefficiencies.

Core Features & Use Cases

  • Merge-base scoped diffs: Scopes analysis to git merge-base vs current working tree including staged, unstaged, and untracked production files.
  • Data-flow first analysis: Prioritizes algorithmic and data-pipeline issues (redundant passes, state duplication, algorithm-problem mismatch).
  • Quantified, verifiable proposals: Requires exact file paths and line numbers, concrete line-count eliminations, and ranked, shippable phases written to PLAN.md.
  • Phased workflow & tooling: Parallel explore agents, Sonnet-class quantification, scorecard, and declined-suggestion tracking for iterative reviews.
  • Use Case: Use this skill when preparing a branch for a large refactor or release to ensure simplifications are high-impact, behavior-preserving, and verifiable.

Quick Start

Run a CTO-level review of the current branch diff against a base ref and produce a ranked, line-numbered PLAN.md with concrete simplification steps.

Frequently Asked Questions about cto-review

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

FAQPage Schema
How do I review a git branch diff for architectural complexity before a merge?

To review a git branch diff for architectural complexity, analyze the merge-base scoped diff to identify data-flow redundancies and structural smells. This produces a ranked simplification plan with exact file paths and line numbers, prioritizing behavior-preserving changes over cosmetic edits.

What is a merge-base scoped diff and when do I need it for code review?

A merge-base scoped diff compares the current working tree, including staged, unstaged, and untracked production files, against a base git reference. You need it for code review when preparing a branch for a large refactor or release to ensure high-impact, verifiable simplifications.

How do I generate a ranked simplification plan from a code diff?

Generate a ranked simplification plan from a code diff by analyzing data-flow and algorithmic issues such as redundant passes and state duplication. The output is a verifiable PLAN.md containing independent, shippable phases with concrete line-count eliminations and exact citations.

Can I use automated architectural review to find algorithmic and data-flow smells in my code?

Yes, automated architectural review can find algorithmic and data-flow smells by prioritizing pipeline issues over cosmetic changes. It requires exact file paths and line numbers, excludes test code, and quantifies complexity to reduce long-term maintenance burden and runtime inefficiencies.

What are the limitations of using git diffs for structural code analysis?

Limitations of using git diffs for structural code analysis include the exclusion of test code from the review scope and the requirement for exact merge-base diffs. Analysis is strictly scoped to production files, meaning untested edge cases or non-production environments are not evaluated.

Does cto-review work with untracked production files in a working tree?

Yes, cto-review works with untracked production files by including them in the merge-base scoped diff alongside staged and unstaged changes. It analyzes these files to identify data-flow and structural smells while explicitly excluding test code from the architectural review.