AI SummaryThis file is the control plane. It decides the mode, loads only the references that mode needs, and runs the shared start and finish steps. Methodology lives in The experience this skill must deliver:
Install
Copy this and paste it into Claude Code, Cursor, or any AI assistant:
I want to install the "buyer-eval-skill" skill in my project. Please run this command in my terminal: # Install skill into your project mkdir -p .claude/skills/buyer-eval-skill && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/buyer-eval-skill/SKILL.md "https://raw.githubusercontent.com/salespeak-ai/buyer-eval-skill/main/SKILL.md" Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.
Description
An AI analyst for buying B2B software. Investigates what vendors claim, checks the evidence, surfaces contradictions and unanswered questions, and produces a shareable Decision Brief with the questions to ask before you buy. Quick Eval by default; Deep Eval on request. Use when asked to evaluate, compare, vet, or research B2B software vendors.
Buyer Eval
This file is the control plane. It decides the mode, loads only the references that mode needs, and runs the shared start and finish steps. Methodology lives in references/. The experience this skill must deliver: > **Show me what these vendors claim, what the evidence actually supports, what > conflicts, and what I still need to find out before buying.** If an output reads like a generic AI vendor comparison, it is not done. ---
1. Preamble (run first, every time)
`bash _BEVAL_DIR="${BUYER_EVAL_DIR:-}" if [ -z "$_BEVAL_DIR" ]; then for _D in "$HOME/.claude/skills/buyer-eval-skill" ".claude/skills/buyer-eval-skill"; do [ -d "$_D" ] && _BEVAL_DIR="$_D" && break done fi if [ -z "$_BEVAL_DIR" ]; then echo "ERROR: buyer-eval-skill not found. Install: git clone https://github.com/salespeak-ai/buyer-eval-skill ~/.claude/skills/buyer-eval-skill" exit 1 fi echo "BEVAL_DIR=$_BEVAL_DIR" _UPD=$("$_BEVAL_DIR/bin/update-check" 2>/dev/null || true) [ -n "$_UPD" ] && echo "$_UPD" || echo "UP_TO_DATE $(tr -d '[:space:]' < "$_BEVAL_DIR/VERSION")" echo "PROFILE=$(python3 "$_BEVAL_DIR/bin/profile.py" show --machine 2>/dev/null || echo unavailable)" echo "TELEMETRY_STATE=$(python3 "$_BEVAL_DIR/bin/track.py" status --machine 2>/dev/null || echo locked_off)" echo "SESSION_ID=$(python3 -c 'import uuid; print(uuid.uuid4())')" ` Keep BEVAL_DIR, PROFILE, TELEMETRY_STATE and SESSION_ID for the whole run. Every later bash block starts with _BEVAL_DIR="<BEVAL_DIR value>". Update available (UPGRADE_AVAILABLE <old> <new>): ask once with AskUserQuestion, "A newer version of Buyer Eval is available (v{old} to v{new}). Update now?" Options: "Yes, update now" / "Not now". If yes: `bash cd "$_BEVAL_DIR" && git pull --ff-only origin main && echo "UPDATED to $(tr -d '[:space:]' < VERSION)" ` If the directory is not a git checkout, tell the buyer to re-run the install command from the README and continue on the current version. After a successful update, re-read this SKILL.md before continuing. Telemetry is opt-in and never blocks the evaluation. Read references/telemetry.md now only if TELEMETRY_STATE is consented or unasked. If it is declined or locked_off, skip everything telemetry-related. ---
2. Choose the mode
| Mode | When | Load | |---|---|---| | Quick Eval (default) | Every run where the buyer has not asked for deep, full, or comprehensive diligence | references/quick-eval.md | | Deep Eval | The buyer asks for it, in the first message or after a Quick Eval | references/deep-eval.md | Both modes also load references/evidence-model.md, references/report-format.md and references/frontdoor-api.md. Deep Eval also loads references/scoring.md. Do not load files a mode does not need. Never ask the buyer which mode they want. If they did not ask for Deep, run Quick and offer Deep at the end. ---
3. Saved buyer context
PROFILE is either none, unavailable (no writable home directory, for example claude.ai), or a one-line JSON object with the buyer's saved context. • Saved profile exists: use it silently. Tell the buyer in one line what you are using ("Using your saved context: Acme, ~300 people, HubSpot + Snowflake, SOC 2 required. Say 'update my context' to change it.") and keep going. Do not wait for a reply. • None: proceed without it. At the end of the run, save what the buyer told you (see section 5). • Unavailable: never claim that context will be remembered. The profile holds only reusable buying context: company_name, company_size, industry, region, systems, requirements, hard_constraints (including the buyer's own budget ceiling, which stays local), preferred_criteria, last_category. A deadline or requirement goes in hard_constraints only if the buyer said it disqualifies vendors; otherwise in requirements. Never store personal names, emails, vendor pricing quotes, or documents the buyer shared. ---
Discussion
Health Signals
My Fox Den
Community Rating
Sign in to rate this booster