Scalpel

🔪 Surgical AI for your codebase. Diagnose. Assemble. Operate. Zero side effects.

Install

npx -y skills add anupmaster/scalpel

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Surgical AI for your codebase. Plugs into any project, performs a 12-dimension diagnostic scan (git forensics, architecture, tech debt, security, infrastructure), delivers a Codebase Vitals health score, then assembles and manages an adaptive AI surgical team calibrated to YOUR project. Pendrive architecture — plug in, work, unplug, zero trace. Also ships a standalone bash scanner (zero AI, zero tokens) for instant codebase health checks.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.3 KB, as published. Nobody here has run it

Scalpel — Surgical AI for Your Codebase

12-dimension diagnostic. Adaptive surgical teams. Zero side effects.

Installation

# Claude Code
git clone https://github.com/anupmaster/scalpel.git ~/.claude/skills/scalpel

# Codex CLI
git clone https://github.com/anupmaster/scalpel.git ~/.agents/skills/scalpel

# Any project (pendrive style)
cd your-project && git clone https://github.com/anupmaster/scalpel.git .scalpel && .scalpel/install.sh

Usage

> Hi Scalpel, start work
> scalpel scan              # Diagnostic only, no changes
> scalpel skip recon        # Jump to task execution

Standalone Scanner (Zero AI)

./src/scanner.sh                # Pretty terminal output
./src/scanner.sh --json         # Machine-readable
./src/scanner.sh --score-only   # Just the number: "83"

What It Does

Diagnose — Scans 12 dimensions: stack, architecture, git forensics, database, auth, infrastructure, tests, security, integrations, agent ecosystem, code quality, performance
Consult — Delivers Codebase Vitals health score, asks targeted questions
Assemble — Designs a custom surgical team calibrated to YOUR project
Operate — Spawns parallel agents in isolated worktrees with file jurisdiction
Close — Delivery report, session memory saved, optional regression monitoring

Features

Standalone scanner — Pure bash, zero AI, zero tokens. Runs anywhere.
12-dimension diagnostic — Deeper than any linter. Reads git history, deleted files, abandoned branches.
Adaptive teams — Not templates. Teams shaped by YOUR project's needs.
File jurisdiction — Each agent owns specific files. Zero merge conflicts.
Agent scoring — Quality enforcement. Score < 50 = agent terminated.
Session memory — Remembers previous sessions. Gets smarter over time.
Pendrive architecture — Plug in, work, unplug. Zero trace.
7 agent adapters — Claude Code, Codex, Gemini, Cursor, Windsurf, Aider, OpenCode.
GitHub Action — Automated PR health checks.
Extensible config — Custom scan dimensions, team roles, scoring rules.

Permissions

Read-only during diagnostic. Write access only during surgical team operation. Never modifies your existing CLAUDE.md, agents, commands, or settings. Never commits itself to your git history. Uninstall leaves zero trace.