whatisgithub

What is simulacra?

mturac/simulacra — explained in plain English

Analysis updated 2026-05-18

53Audience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A skill for AI coding assistants that reviews code through several fictional 'ghost' personas, each hunting for a different class of bug before you ship.

Mindmap

mindmap
  root((Simulacra))
    What it does
      Ghost persona code review
      Bug timelines and reports
      Skill Scorer add on
    Tech stack
      Markdown skills
      TypeScript examples
    Use cases
      Pre ship code review
      Business logic bug hunting
      Skill quality scoring
    Audience
      Developers
      AI coding tool users

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 build with it?

USE CASE 1

Review a pull request through several fictional personas before merging it.

USE CASE 2

Catch business logic bugs like currency or tax handling mistakes early.

USE CASE 3

Simulate infrastructure failures such as timeouts and partial writes against new code.

USE CASE 4

Score a skill instruction file for quality before sharing it with others.

What is it built with?

MarkdownTypeScript

How does it compare?

mturac/simulacraadityagahlot/obsidian-desktop-widgetadtyahac/acrobat-editor
Stars535353
LanguageJavaScriptC++
Setup difficultyeasyeasymoderate
Complexity2/52/52/5
Audiencedevelopergeneralgeneral

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Installs as a plugin or skill file with no build step or extra dependencies.

So what is it?

Simulacra is a skill for AI coding assistants that reviews code by pretending to be several different fictional users trying to break it. Instead of returning a plain list of lint style warnings, it generates a small cast of ghost personas, each one hunting for a different kind of problem, and has them narrate a short story of exactly how your code would fail in their hands. Three ghosts run by default, with up to seven available on request. The Adversary looks for things like race conditions and back button abuse. Enterprise Edge looks for business logic gaps such as multi currency handling or tax rules. Chaos Monkey simulates infrastructure problems like timeouts and partial failures. Other optional ghosts focus on readability for future maintainers, performance at much larger scale, security and compliance issues, and long term maintenance risk. Each ghost produces a timeline of what it did, a description of what broke, and a bug report with a severity and suggested fix, plus a machine readable version for feeding into other tools. A built in complexity check skips this whole process for trivial changes, so simple code is not forced through unnecessary theater. The project also includes a second, separate skill called Skill Scorer, which rates any skill instruction file on a 0 to 100 scale across ten dimensions and gives a clear verdict of ship it, rework, or scrap. Simulacra installs as a skill or plugin into several AI coding tools, including Claude Code, Codex CLI, Cursor, Windsurf, and others, and is built entirely from plain markdown files with no external dependencies or build step. According to the project's own benchmark against 25 code snippets with known bugs, it correctly found about 83 percent of the seeded bugs, with a false positive rate under 4 percent. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Run Simulacra's ghost review on this function and list every bug the ghosts find.
Prompt 2
Have the Enterprise Edge ghost review this checkout code for business logic gaps.
Prompt 3
Score this SKILL.md file with the Skill Scorer and tell me if it should ship.
Prompt 4
Explain what the Chaos Monkey ghost would report about this database write.

Frequently asked questions

What is simulacra?

A skill for AI coding assistants that reviews code through several fictional 'ghost' personas, each hunting for a different class of bug before you ship.

How hard is simulacra to set up?

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

Who is simulacra for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.