whatisgithub

What is qiaomu-heavyskill?

joeseesun/qiaomu-heavyskill — explained in plain English

Analysis updated 2026-05-18

71Audience · developerComplexity · 2/5Setup · moderate

In one sentence

A Claude Code skill that runs several independent AI agents on the same hard question in parallel, then uses OpenAI Codex to deliberate and synthesize a deeper conclusion.

Mindmap

mindmap
  root((heavyskill))
    What it does
      Parallel AI agents
      Isolated reasoning
      Codex deliberation
      Synthesized conclusion
    Tech stack
      Claude Code
      OpenAI Codex plugin
    Modes
      Verification mode
      Deliberation mode
    Output
      Reasoning traces
      Markdown report
      HTML report
      PDF report
    Requirements
      Claude Code installed
      Codex plugin installed

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

Get a more thorough, multi-perspective analysis of a hard technical or strategic question before deciding.

USE CASE 2

Compare competing technical or product choices, such as architecture options, through a structured multi-agent debate.

USE CASE 3

Produce a shareable PDF report that documents the full reasoning process behind a decision, not just the final answer.

What is it built with?

Claude CodeOpenAI Codex

How does it compare?

joeseesun/qiaomu-heavyskillagg23/fpga-gameandwatchprimeintellect-ai/experiments-autonomous-speedrunning
Stars717171
LanguageSystemVerilogPython
Last pushed2023-10-11
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity2/54/54/5
Audiencedevelopergeneralresearcher

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires both Claude Code and the OpenAI Codex plugin installed and authenticated before it can run.

No license information is stated in the README.

So what is it?

Qiaomu-heavyskill is a skill plugin for Claude Code that gives it a multi-agent deliberation mode for hard questions. The problem it solves is that asking a single AI a complex question yields one perspective, and you cannot easily tell whether that perspective is incomplete or missing critical blind spots. This tool instead runs 3 to 5 fully isolated AI agents in parallel, each reasoning independently about the same question without seeing the others' work, then uses OpenAI Codex to host a critical deliberation session that synthesizes all the different perspectives into a deeper conclusion. The key claim, backed by a referenced arXiv paper, is that deliberation between multiple reasoning traces is generative rather than just averaging: the synthesizer sometimes produces correct answers that none of the individual agents reached on their own. Each run produces a folder of output files including individual reasoning traces as Markdown documents, the raw Codex deliberation output, a polished final report in Markdown and HTML, and a combined PDF suitable for sharing. It supports two modes: a verification mode for questions that have objectively better answers (such as debugging a bug or checking a math derivation), and a deliberation mode for questions with no single right answer (such as choosing a software architecture or evaluating a product strategy). You trigger it through natural language prompts in Claude Code rather than specific commands. It requires both Claude Code and the OpenAI Codex plugin to be installed, since Codex serves as the deliberation moderator.

Copy-paste prompts

Prompt 1
Install qiaomu-heavyskill in Claude Code and ask it to deliberate on whether my product should ship as SaaS or on-premise.
Prompt 2
Use heavyskill's verification mode to double-check a tricky bug analysis with multiple independent AI reasoning passes.
Prompt 3
Set up the OpenAI Codex plugin required by qiaomu-heavyskill by running /plugin marketplace add openai/codex-plugin-cc and /codex:setup.
Prompt 4
Ask heavyskill to run deliberation mode comparing two software architecture options and summarize the tradeoffs each trace missed.

Frequently asked questions

What is qiaomu-heavyskill?

A Claude Code skill that runs several independent AI agents on the same hard question in parallel, then uses OpenAI Codex to deliberate and synthesize a deeper conclusion.

What license does qiaomu-heavyskill use?

No license information is stated in the README.

How hard is qiaomu-heavyskill to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is qiaomu-heavyskill for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.