sherlock

Investigate codebase performance issues and flaky tests through autonomous experiments.

27|1|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/Codeminer42/skills --skill sherlock-codeminer42
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sherlock
Source: https://github.com/Codeminer42/skills/tree/main/sherlock
Command: npx skills add https://github.com/Codeminer42/skills --skill sherlock-codeminer42

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Autonomous investigation loop to identify and fix performance issues, intermittent errors, flaky tests, memory leaks, slow operations, and reliability problems in a codebase.

Core Features & Use Cases

  • Autonomous investigation loop: run experiments, measure results, log outcomes, and decide to keep or revert changes.
  • Baseline-driven remediation: establish baselines, create branches, and iterate until health is restored.
  • Scoped investigation: focus on tests, perf, memory, or specific files or directories.

Quick Start

Invoke sherlock on your project to begin the autonomous investigation loop.

Frequently Asked Questions about sherlock

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

FAQPage Schema
How do I autonomously fix flaky tests and memory leaks in my codebase?

You can fix flaky tests and memory leaks by running an autonomous investigation loop that establishes baselines, runs experiments, measures results, and keeps or reverts changes based on evidence. This loop requires a Git repository with standard project metadata.

What is the best way to automate reliability improvements in CI workflows?

Automating reliability improvements in CI workflows involves running an autonomous health-improvement loop that iterates on performance issues and intermittent errors. It creates branches, runs baseline tests, and logs results to a dedicated .claude/sherlock directory for traceability.

Can I scope an autonomous investigation to specific files or directories?

Yes, you can scope the autonomous investigation to focus on specific files, directories, tests, performance, or memory issues. This targeted approach ensures the health-improvement loop only runs experiments and measures results in the areas you specify.

Does this autonomous investigation approach require any specific project setup?

Autonomous investigation requires a Git repository with standard project metadata to function correctly. It uses this setup to create branches, establish baselines, run test experiments, and log outcomes to a dedicated directory for ongoing traceability.

How does an autonomous investigation loop decide whether to keep or revert code changes?

The autonomous investigation loop decides to keep or revert code changes by measuring experiment results against established baselines. If a change resolves a performance issue or reliability problem without regressions, it is kept; otherwise, it is reverted.

Why are my performance issue fixes not persisting across CI runs?

Performance fixes may not persist if they are not validated through a baseline-driven remediation loop. An autonomous investigation establishes baselines, measures results against them, and logs outcomes to a dedicated directory to ensure only evidence-backed changes are kept.