CommunityCodierung & Entwicklunggithub.com

truth-serum

Das Verbraucherpanel. Startet einen Schwarm von Buyer-Sub-Agents (Standard 100, --quick für 20), die auf den Zielkunden des Benutzers trainiert sind, jeweils mit unterschiedlichem Einkommen, Alter, Kaufverhalten und Einwänden. Zeigt allen denselben Pitch und durchläuft 100 Kaufszenarien, um zu sehen, wer kauft, wer nicht und warum. Fasst die Antworten in Kaufraten nach Segmenten zusammen, gibt die Ablehnungsgründe in eigenen Worten wieder, zeigt, was ein Nein in ein Ja verwandeln würde, und liefert Preisantwoorten für den Litmus-Test. Jedes Ergebnis ist als SIMULATED gekennzeichnet: Es findet Einwände und die Fragen, die man echten Käufern stellen sollte, und zählt nie als Nachfrage. Verwenden Sie dies, wenn der Benutzer sagt: „Würden Leute das kaufen?“, „Teste es an Kunden“, „Starte das Verbraucherpanel“, „Simuliere Käufer“, „Wer ist mein Kunde?“ oder „Validiere die Nachfrage“.

Was ist truth-serum?

truth-serum ist ein KI-Agenten-Skill, der ein simuliertes Verbraucherpanel erstellt, um Einwände, Segmente und Fragen für die echte Marktforschung zu identifizieren. Anstatt zu raten, welche Einwände Käufer haben könnten, startet der Skill einen Schwarm von Sub-Agents (standardmäßig 100, mit --quick 20), die jeweils als ein bestimmter Käufer aus dem Zielkundenprofil agieren – mit unterschiedlichem Einkommen, Alter, Kaufverhalten und spezifischen Zweifeln. Alle Sub-Agents sehen denselben Pitch und der Benutzer fungiert als Moderator, ohne jemals für einen Käufer zu antworten. Das Tool protokolliert jede Antwort in strukturierten JSON-Dateien und erstellt eine finale Auswertung mit Kaufraten, Ablehnungsgründen in eigenen Worten, Bedingungen für eine Kaufumkehr und Preiseinschätzungen. Die Ergebnisse sind explizit als SIMULATED gekennzeichnet, um klarzustellen, dass sie keine echte Nachfrage darstellen, sondern als obere Schranke und zur Schärfung von Fragen für echte Kundengespräche dienen. Der Skill ist für Claude Code optimiert, nutzt die Sub-Agent-Funktion (früher Task genannt) und erfordert die vorherige Lektüre der Regeln im receipts-Verzeichnis. Er ist besonders nützlich für Validierungsfragen wie „Würden Leute das kaufen?“, „Teste es an Kunden“ oder „Wer ist mein Kunde?“ und arbeitet mit anderen Skills wie /litmus (Preisanalyse), /dealbreaker und /signal zusammen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/peaknr35/shark-Tank-proof/tree/main/skills/truth-serum

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht truth-serum?

Statt zu raten, welche Einwände Käufer erheben werden, fragen Sie hundert simulierte, von denen jeder ein Sub-Agent ist, der einen bestimmten, aus Ihrem Zielkunden abgeleiteten Käufer spielt. Sie sind der Moderator. Sie antworten niemals für einen Käufer.

Wofür das gedacht ist: Einwände, Segmente, Formulierungen und die Fragen zu finden, die man echten Menschen stellen sollte. Was es nicht ist: Nachfrage. Sprachmodelle neigen zur Zustimmung, daher ist eine hohe Kaufrate hier der Best-Case, keine Prognose, und es kann einen Plan scheitern lassen, aber nie bestehen.

Lesen Sie zuerst ${CLAUDE_SKILL_DIR}/../receipts/rules.md.

Was der Benutzer nach /truth-serum eingegeben hat: $ARGUMENTS

Das Tool

Die gesamte Buchhaltung erfolgt über panel.py im Ordner dieses Skills:

python3 "${CLAUDE_SKILL_DIR}/panel.py" <Befehl>

Im Folgenden bedeutet PANEL genau das. Wenn der Pfad nicht expandiert ist, verwenden Sie das Basisverzeichnis, das Claude Code für diesen Skill druckt. Der Zustand befindet sich in founder/panel/.

Schritt 1: Der Zielkunde

Schreiben Sie founder/customer.json (Form: customer.example.json in diesem Ordner):

  • business und target: Wer der Kunde ist, in einem bestimmten Satz.
  • segments: 2 bis 4 Gruppen mit einem share und einem income-Bereich [low, high].
  • behaviours: 4 bis 8 Kaufverhalten mit einem share und einer how-Zeile (täglich, regelmäßig, Schnäppchenjäger, liest jede Bewertung, loyal zu einem Wettbewerber ...).
  • objections: Die 4 bis 8 Zweifel, die diese Art von Käufer wirklich hat.
  • habits (optional): Alltagskontextzeilen, die einen Käufer konkret machen.

Verankern Sie es in etwas Realem. Verwenden Sie, was der Benutzer über seine Kunden weiß, und falls /ground-truth ausgeführt wurde, die Beschwerden in founder/competitors.md. Wenn der Benutzer echte Kundendaten hat (Gesprächsnotizen in founder/evidence/calls/, Rezensionen, Umfrageantworten), ziehen Sie diese Ihren Vermutungen vor und sagen Sie, welche Teile Vermutungen sind.

Wenn das Ziel eine kleine Gruppe von Unternehmen ist (einige hundert Firmen, kein Massenmarkt), sagen Sie klar, dass fünf echte Anrufe mehr lehren als dieses Panel, und bieten Sie zuerst /receipts und seinen Gesprächsleitfaden an. Führen Sie das Panel nur durch, um die Fragen zu schärfen. Zeigen Sie dem Benutzer das Profil in wenigen Zeilen und lassen Sie es korrigieren, bevor Sie fortfahren: Ein falscher Kunde macht das gesamte Panel falsch.

Schritt 2: Der Pitch

Schreiben Sie founder/pitch.md: Was ein Käufer tatsächlich sehen würde. Das Produkt, der Preis, wo und wie man es bekommt, etwaige Einführungsangebote. Drei bis sechs klare Zeilen, keine Übertreibungen, nichts, was das Unternehmen nicht liefern kann. Jeder Käufer sieht genau dies.

Schritt 3: Austeilen und ausführen

PANEL init --customer founder/customer.json --pitch founder/pitch.md --n 100
PANEL prompts

init teilt die Persona-Karten aus (gleicher Seed, gleiche Karten; der Seed wird aufgezeichnet). prompts schreibt eine Aufgabenbeschreibung pro Käufer und listet sie in Wellen von 10 auf. Senden Sie für jede Welle EINE Nachricht mit einem Agent-Tool-Aufruf pro Käufer in dieser Welle (das Agent-Tool heißt in älteren Claude Code Versionen Task):

  • subagent_type: general-purpose
  • description: panel <ID>
  • prompt: Lies <Aufgabenpfad> und befolge ihn genau. Er ist deine gesamte Aufgabenstellung.

Warten Sie auf die gesamte Welle, bevor Sie mit der nächsten beginnen. Claude Code führt standardmäßig etwa 10 Tool-Aufrufe gleichzeitig aus, also sind 100 Käufer 10 Wellen. Nach der letzten Welle:

PANEL check      # listet fehlende oder fehlerhafte Antworten auf
PANEL prompts    # schreibt Aufgabenbeschreibungen nur für diese neu; führen Sie sie einmal erneut aus
PANEL tally

Wenn ein Käufer sein JSON in seiner Antwort anstatt in der Datei ausgegeben hat (das kommt vor), erfassen Sie seine Antwort mit PANEL save <ID> und der Antwort über stdin; save lehnt alles ab, was keine gültige Antwort ist. Ein Käufer, der zweimal scheitert, wird ausgelassen und in den Ergebnissen gezählt. Schreiben Sie niemals selbst eine Antwort für einen Käufer.

Informieren Sie den Benutzer vor einem Lauf mit 100 Käufern, dass es 100 Sub-Agent-Aufrufe sind, und schlagen Sie --quick (20 Käufer) für einen ersten Eindruck vor. Sub-Agents schreiben jeweils eine Datei in founder/panel/answers/; im Standard-Berechtigungsmodus ist das eine Genehmigung pro Datei, also schlagen Sie den accept-edits-Modus (Umschalt+Tab) für den Lauf vor.

Schritt 4: Dem Benutzer vorlesen

PANEL tally schreibt founder/panel/results.md und results.json. Geben Sie dem Benutzer:

  1. Die harte Wahrheit: Der stärkste Grund, warum Käufer ablehnen, in einem Satz, und eine Erinnerung daran, dass die Kaufrate simuliert und eine obere Schranke ist.
  2. Die Schlagzeile: „40 kaufen · 60 lehnen ab (simuliert)“ und die Kaufrate.
  3. Wer kauft und wer nicht: Die Segment- und Verhaltenszeilen, die sich am stärksten unterscheiden.
  4. Warum sie ablehnen: Die drei häufigsten Gründe mit jeweils einem Zitat, wie geschrieben.
  5. Was ein Nein umkehren würde: Die am häufigsten wiederholten Antworten.
  6. Ein Satz darüber, was geändert werden sollte, bevor Geld ausgegeben wird, und welcher Skill das erledigt (Preisgestaltung, Angebot, Marketing).
  7. An echte Menschen weitergeben: Die drei häufigsten Einwände, in Fragen für echte Gespräche umgewandelt, im Stil von ${CLAUDE_SKILL_DIR}/../receipts/conversations.md (über ihre Vergangenheit, nicht über Ihre Idee). Das ist die eigentliche Aufgabe des Panels.

Protokollieren Sie dann das Ergebnis als SIMULATED:

python3 "${CLAUDE_SKILL_DIR}/../receipts/ledger.py" add --kind demand --status SIMULATED --use PRIVATE --by truth-serum --claim "Simulierte Panel-Kaufrate (Seed <S>)" --number "<Käufe> von <Beantworteten>"

Ehrliche Grenzen, einmal ausgesprochen

Dies sind simulierte Käufer. Sie sind gut darin, Einwände, Segmente und Formulierungen aufzudecken, an die Sie nicht gedacht haben, und schlecht darin, reale Konversionen vorherzusagen: Sprachmodelle neigen zur Zustimmung, also behandeln Sie die Kaufrate als obere Schranke. Bestätigen Sie die großen Erkenntnisse mit echten Menschen (einer Warteliste, einem Vorverkauf, einem Pilotprojekt, einer Landingpage mit Preis), bevor Sie irgendetwas unterschreiben. Nennen Sie das Panel niemals „Validierung“, „Marktforschung“ oder „Kunden“ und zitieren Sie niemals einen Panel-Käufer als Kunden: nicht in einem Pitch, einer Anzeige, einem Deck oder einem Zuschussantrag.

Die Aufgabenstellung, die jeder Käufer erhält

panel.py füllt die Karte in eine feste Vorlage (siehe BRIEF im Skript): Wer der Käufer ist (Name, Alter, Segment, Einkommen, Kaufverhalten, eine Gewohnheit, der Zweifel, der ihm in den Sinn kommt), der Pitch Wort für Wort, eine Anweisung, nicht zustimmend zu sein und keine Tatsachen zu erfinden, und das genaue JSON, das geschrieben werden soll: Käufe, Einkäufe im ersten Monat, ein Grundcode, der Grund in seiner eigenen Stimme, sein Haupteinwand, was seine Meinung ändern würde, und vier Preisantworten (zu billig, ein Schnäppchen, wird teuer, zu teuer). Bearbeiten Sie niemals eine Aufgabenstellung für einen bestimmten Käufer.

Ausgabe

founder/customer.json, founder/pitch.md, founder/panel/ (Karten, Aufgaben, Antworten, Ergebnisse). Als Nächstes: /litmus liest die Preisantworten, /dealbreaker und /signal lesen die Einwände.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

burn-test

Your CFO. Builds the unit economics of a business before money is spent: what one unit earns after its direct costs, the real profit margin at the planned volume, the break-even point in units a day, year 1 month by month, the cash needed before it pays for itself, how long the startup spend takes to earn back, and what happens if the price drops, sales come in low or costs rise. Every number traces to an input the user can check. Use when the user says "find the profit margins", "do the numbers", "is this profitable", "break-even", "unit economics", "how much do I need to start", or "run the CFO".

dealbreaker

Builds an offer too good to refuse. Lists every problem the buyer hits on the way to the result they want, turns each into a solution, trims to what is cheap to deliver and valuable to the buyer, and stacks it with honest bonuses, a guarantee the CFO can afford, real urgency and a clear name. Scores it on the value equation (outcome, likelihood, time, effort) and re-tests it on a quick buyer panel. Use when the user says "make my offer better", "why won't people buy", "what should I include", "guarantee", "bonuses", "grand slam offer", or after the panel shows people passing.

handshake

Turns the founder folder into the thing that gets one real person to say yes to the next step: a one-page pilot offer for a customer, an NSF Project Pitch or grant answer for a funder, an investor or lender one-pager, a business case for a boss, or an invite for the people who will use it. Always writes the one-sentence, three-sentence and three-minute versions first. Builds only from claims in the evidence ledger that the audience may see, never from simulated buyers, and checks the finished pitch with the ledger before it goes out. Use when the user says "pitch this", "write a pilot offer", "one-pager", "grant pitch", "NSF pitch", "deck for", "email this customer", "business case", or "what do I send them".

kill-or-build

Your business planner. Compiles everything the other Shark Tank Proof skills wrote (the board's verdict, the competitors, the buyer panel, pricing, the offer, the CFO's numbers, marketing, brand, operations, the launch plan and the evidence ledger) into one business plan with a verdict at the top that is computed, never written by hand: Profitable (the numbers pass and a real buyer has paid, signed or booked), Unproven (works on paper, no real buyer yet), Not yet (with the failing numbers) or Incomplete. A simulated panel can fail a plan but never pass one. Adds an executive summary and a one-page version. Use when the user says "write my business plan", "put it all together", "is it profitable", "give me the plan", or at the end of the Shark Tank Proof pack.

shark-board

Your board of directors, built to disagree with you. Puts a business idea in front of a four-member board, each a sub-agent reading the idea through one published framework: the Offers lens (from Alex Hormozi's $100M Offers), the Monopoly lens (from Peter Thiel's Zero to One), the Product lens (from Walter Isaacson's biography of Steve Jobs) and the Evidence lens (from Rob Fitzpatrick's The Mom Test), which scores only what real people have done. Each member scores the idea, names what would kill it and the cheapest test that would prove it, and votes fund, fund with conditions, or pass. Use when the user says "test my business idea", "would this work", "pressure-test this", "what would a board say", "is this a good business", or starts the Shark Tank Proof pack on a new idea.

Verwandte Skills