git404hub

what is scalpel fr?

anshaneja5/scalpel — explained in plain English

Analysis updated 2026-05-18

12PythonAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A drop-in skill for AI coding agents like Claude Code that makes them write the smallest working code by reusing existing tools first, while still protecting validation, security, and accessibility.

vibe map

mindmap
  root((scalpel))
    What it does
      Minimal code skill
      Reuse before writing new
      Protects validation and security
    Tech stack
      Claude Code skill
      Python benchmarks
      Promptfoo
    Use cases
      Cut token and cost use
      Keep safety checks intact
      Benchmark against similar skills
    Audience
      AI agent users
      Developers
    Setup
      Plugin install
      Copy skill file
      Toggle on or off

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Install this skill into Claude Code or another AI agent so it writes smaller, more minimal code by default.

VIBE 2

Reduce token usage and cost on AI coding sessions while keeping validation and security checks intact.

VIBE 3

Compare AI coding agent output against a similar minimalism skill using the included benchmark harness.

what's the stack?

PythonClaude Code PluginPromptfooMarkdown

how it stacks up fr

anshaneja5/scalpelaim-uofa/reasonmatchairbone42/360-data-athlete
Stars121212
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/55/54/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Install via a Claude Code plugin command or by copying one file into a project's skills folder, no infra required.

MIT license: free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

Scalpel is a set of instructions, called a skill, that you can install into an AI coding agent such as Claude Code to change how it writes code. Instead of writing brand new code for every request, it tells the agent to first check whether something is really needed, then look for an existing way to solve it: something already in the project's own code, something built into the programming language or platform, or an already installed package, before writing anything new. Only if none of those exist does it write new code, and only the smallest amount needed. The skill also tells the agent to make a plan for a task once and stick with it, rather than reconsidering its approach on every reply, which the author says wastes time and cost. It protects certain things from being cut for the sake of brevity, such as input validation, error handling, security checks, and accessibility, and its replies are meant to be mostly code with very little explanatory text. The README includes benchmark results comparing this skill to a similar project called ponytail, using that other project's own test setup so the comparison uses the same tasks and scoring method. Across tests with several Claude models, the author reports this skill produced less code, used fewer tokens, cost less to run, and matched or beat the other project on correctness in every case tested. A separate test using real coding sessions on a sample web app project found the two projects performed about the same overall. To install it, you can use a plugin command in Claude Code, or copy a single instructions file into a project's skills folder, or paste its contents into the system prompt of any AI agent that accepts one. It can be turned off at any time by telling the agent to stop using it or switch to normal mode, and it will still build a fuller version of something if you specifically ask for one. The project is released under the MIT license.

prompts (copy fr)

prompt 1
Install the scalpel skill in Claude Code and show me how it changes the code you generate for a simple form validator.
prompt 2
Explain scalpel's five step decision order for deciding whether to write new code.
prompt 3
Walk me through running the benchmark in this repo's benchmarks folder to compare scalpel against the baseline.
prompt 4
Show me how to turn scalpel off temporarily and ask for a fuller, less minimal version of a component.

Frequently asked questions

what is scalpel fr?

A drop-in skill for AI coding agents like Claude Code that makes them write the smallest working code by reusing existing tools first, while still protecting validation, security, and accessibility.

What language is scalpel written in?

Mainly Python. The stack also includes Python, Claude Code Plugin, Promptfoo.

What license does scalpel use?

MIT license: free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is scalpel to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is scalpel for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.