Skip to main content
skill CX Codex

vendor-evaluation — Claude Code skill: what it does, how to install

vendor-evaluation guides vendor selection, compares SaaS tools on a weighted scorecard, and prepares contract terms before renewal.

MIT 295 installs ★ 1,107 updated 2026-10-19

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add rampstackco/claude-skills --skill vendor-evaluation -a claude-code
Open on GitHub

What vendor-evaluation does

This skill structures procurement across five sequential phases. It starts by pinning down operational requirements, followed by an explicit build versus buy evaluation. When purchasing wins, it narrows down an initial pool of 5–8 options down to 2–4 qualified finalists.

Evaluation relies on a weighted rubric. Functional fit accounts for 40%, technical fit takes 15%, operations take 10%, security accounts for 10%, vendor stability is 10%, total cost takes 10%, and vendor lock-in risk holds 5%. Each candidate gets scored from 1 to 5 across these dimensions.

Specific contract clauses and legal obligations remain out of scope; those tasks require consultation with legal counsel.

What it helps with

  • decide whether to build internally or buy existing software
  • filter vendor shortlists down to top finalists
  • score vendors systematically across weighted operational criteria
  • prep leverage points and discount strategies for contract discussions

Example prompts for the agent

  • Run a build vs buy analysis for our customer notification service
  • Evaluate three database vendors using the scorecard criteria
  • Identify negotiation points for an upcoming enterprise SaaS renewal

How to install vendor-evaluation

1Skills CLI (Vercel)

npx skills add rampstackco/claude-skills --skill vendor-evaluation -a claude-code

2Manually: put the files in place

~/.claude/skills/vendor-evaluation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/vendor-evaluation/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about vendor-evaluation

How to install vendor-evaluation in Claude Code?

Run npx skills add rampstackco/claude-skills --skill vendor-evaluation -a claude-code. The file will be placed in ~/.claude/skills/vendor-evaluation/SKILL.md.

What does vendor-evaluation do?

It enforces an objective evaluation framework for software procurement. This prevents teams from buying tools based on flashy vendor demos instead of actual fit.

When should you skip this skill?

Avoid using it for broad cost-cutting initiatives, fine-tuning legal contract language, or engaging agencies for one-off tasks.

Source text

SKILL.md · MIT
---
name: vendor-evaluation
description: "Evaluate, select, and contract with vendors and SaaS tools. Use this skill when comparing alternatives, running an RFP, scoring vendors against criteria, negotiating contracts, planning a switch, or assessing a vendor's risk. Triggers on vendor evaluation, RFP, vendor selection, build vs buy, SaaS evaluation, vendor scorecard, vendor comparison, contract negotiation, vendor switch, procurement. Also triggers when a renewal is coming up or when a tool isn't meeting expectations."
category: process-and-team
catalog_summary: "Tool and vendor selection using a structured rubric"
display_order: 3
---

# Vendor Evaluation

Pick the right tool or service, negotiate fair terms, and avoid the lock-in traps. Stack-agnostic. Applies to SaaS, infrastructure providers, agencies, and any external dependency.

---

## When to use

- Selecting a tool or vendor for a new need
- Evaluating alternatives to a current vendor
- Build vs buy analysis
- Renewal coming up: should we stay or switch?
- Running a formal RFP or RFI
- Comparing finalists in a vendor selection
- Negotiating a contract
- Assessing vendor risk (financial, security, dependency)

## When NOT to use

- General cost reduction (use `cost-optimization`)
- Specific contract legal terms (those go to legal)
- Performance issues with an existing vendor (try fixing before switching)
- Hiring an agency for a one-off project (lighter framework needed)

---

## Required inputs

- The need (what problem are you solving, what would success look like)
- Constraints (budget, timeline, integration requirements)
- Stakeholders (users, IT, security, finance, legal)
- Existing context (what's already used, what's been tried)
- Compliance requirements

---

## The framework: 5 phases

A structured vendor evaluation. Skip phases at your peril.

### Phase 1: Define the need

Before looking at vendors, define what you actually need.

- What problem are you solving?
- What's the user / use case?
- What does "success" look like in 6 months? In 2 years?
- What's the budget (range, not just ceiling)?
- What's the timeline?
- Are there must-have integrations or constraints?

The temptation: skip this and start demoing. Vendors are happy to show off; you end up choosing what looks shiny rather than what fits.

### Phase 2: Build vs buy

Before evaluating vendors, decide whether you should build instead.

**Build when:**
- It's core to the business (differentiating)
- The need is so specific no vendor matches
- The economics work at your scale
- You have the team to maintain it
- Vendor lock-in would be unacceptable

**Buy when:**
- It's table stakes (not differentiating)
- The need is well-served by existing products
- The economics favor it
- The team should focus elsewhere
- The vendor's specialization beats your generalism

Most teams over-build. The rule of thumb: buy unless there's a strong reason to build. Then question even that strong reason.

### Phase 3: Generate the shortlist

Cast a wider net than feels comfortable, then narrow.

Sources:
- Internal team's existing knowledge
- Industry analyst reports (Gartner, Forrester, etc.)
- Peer recommendations (other companies similar to yours)
- Reviews (G2, Capterra; with caveats about review quality)
- Adjacent vendors you already use (often have the feature you need)
- Open-source alternatives

Cast wide first. Aim for 5-8 candidates. Then narrow to 2-4 finalists for deep evaluation.

### Phase 4: Score the finalists

Use a scorecard. Without one, you'll be swayed by demo theatrics or who has the friendliest sales rep.

Scorecard dimensions (weight by your situation):

**Functional fit (40%):** Does it do what you need? Edge cases handled? UX quality. Workflow fit.

**Technical fit (15%):** Integration with your stack. API quality and completeness. Data export and portability. Performance at your scale. Self-hosted, hybrid, or SaaS-only.

**Operational fit (10%):** Onboarding effort. Training and adoption. Documentation quality. Support quality (test by submitting a ticket). SLAs.

**Security and compliance (10%):** SOC 2, ISO 27001, HIPAA, etc., as applicable. Data residency. Encryption at rest and in transit. Access controls and audit logs. Penetration test results (ask). Subprocessors.

**Vendor health (10%):** Years in business. Funding and runway (or revenue if private). Customer base size and similar customers. Public references. Roadmap visibility.

**Cost (10%):** License or subscription cost. Implementation and onboarding cost. Training cost. Integration cost. Opportunity cost (in-house resource time). Switching cost (in case of failure).

**Lock-in risk (5%):** Data export quality. Standard formats vs proprietary. Migration paths to alternatives. Open standards alignment. Contract escape clauses.

Score each finalist 1-5 on each dimension. Multiply by weight. Sum.

The score isn't gospel. It surfaces the tradeoffs.

### Phase 5: Negotiate

Most enterprise contracts are negotiable. Most aren't negotiated.

**What's negotiable:**
- Price (multi-year, volume, prepayment, end-of-quarter timing)
- Terms (payment schedule, renewal terms)
- Success commitments (training, onboarding, support)
- SLAs (uptime, response time, credits)
- Termination clauses (auto-renewal, notice period, data export)
- Liability caps and indemnity (legal will care about these)
- Subprocessors and data handling (security/legal cares)

**Common negotiation moves:**
- Multi-year discount (3-year for a 15-30% discount is common)
- Volume tiers (commit to higher usage for a per-unit discount)
- Annual prepayment for a discount
- Free or discounted onboarding
- Pilot pricing (trial period at reduced rate)
- "Most favored customer" clauses (if your size warrants)

**What to avoid:**
- Multi-year lock with no escape clause for material breach
- Auto-renewal with short notice window (under 60 days; want longer)
- "All right, no further negotiation" stance from the start
- Signing without legal review

---

## Workflow

### Step 1: Define the need

Write a one-page brief: what we need, why, success criteria, constraints, stakeholders.

### Step 2: Build vs buy

Honestly answer the build/buy question. Document the rationale.

### Step 3: Generate shortlist

Wider net first, narrowed via desk research:
- Read summaries
- Skim reviews
- Look at customer logos
- Skim docs
- Skim API specs

Eliminate obvious misfits. Land on 2-4 finalists.

### Step 4: Run demos and trials

For each finalist:
- Demo with the use case (don't take their default demo; bring yours)
- Trial period if possible
- Reference calls with similar customers
- Pilot with real data if feasible

Don't be charmed by the polished demo. Try it with your real workflow.

### Step 5: Run security and compliance review

Critical for any vendor handling sensitive data:
- Request SOC 2 / ISO 27001 reports
- Review their security questionnaire (most have one ready)
- Verify data handling matches your requirements
- Identify subprocessors

This can take weeks for enterprise vendors. Start early.

### Step 6: Score

Apply the scorecard. Do this collaboratively with stakeholders.

The scoring conversation matters more than the final number. It surfaces disagreement (one person scored UX 5, another scored 2: why?).

### Step 7: Negotiate

With the apparent winner:
- Open negotiation by asking for terms (not just price)
- Be willing to walk
- Run negotiations with #2 in parallel where appropriate (gives you leverage)

### Step 8: Plan the rollout

Contract signing is the start, not the end. Plan:
- Onboarding owner
- Training plan
- Migration plan if replacing an incumbent
- Success criteria at 30, 90, 180 days
- Renewal calendar

### Step 9: Document

Record:
- The decision and the rationale
- Alternatives considered
- Scorecard results
- Negotiated terms
- Renewal date and notice deadlines
- Owner of the relationship

This is gold for the next renewal or the next similar evaluation.

---

## Failure patterns

**Skipping the needs definition.** Demoing first. Buying what's shiny. Realizing 6 months in that the actual need wasn't met.

**Single-source decisions.** Talking to one vendor; deciding. No comparison. Probably overpaying or under-fitting.

**Charisma-driven decisions.** Buying based on the sales rep's likability. The product is what you'll use for years; the rep won't be there.

**Reference calls that the vendor curated.** Of course their references love them. Find references the vendor didn't suggest.

**Glossing over security.** Security review skipped because of timeline pressure. Then a breach. Slow down or accept the risk explicitly.

**Demos that don't match the use case.** Their default demo, not yours. Always do a use-case demo.

**Trial that doesn't simulate real usage.** A trial with synthetic data tells you the product works in synthetic conditions. Use real (or close to real) data.

**Negotiating only on price.** Terms, SLAs, and exit clauses matter more for long-term satisfaction than 5% price.

**Auto-renewal without notice tracking.** Renewal happens; rate goes up 15%. No one was watching. Track renewals; review with notice.

**Lock-in without exit plan.** Tightly integrating into a vendor's proprietary surface. When you want to leave, you can't. Plan exit at the start.

**Multi-year contract for an unproven vendor.** Save the multi-year for vendors you trust. New vendor: shorter term, evaluate after.

**No internal champion.** Tool selected; no one drives adoption. Tool sits unused. Identify the champion before signing.

**Negotiating after a verbal commitment.** "Yes, we want to buy" means they have less reason to negotiate. Keep options open until terms are settled.

**Ignoring red flags in security review.** Vendor's security responses are evasive or incomplete. Treat as a no.

**Comparing apples to oranges.** Vendors price differently (per user, per usage, flat). Build a comparable cost model at your scale.

---

## Output format

A vendor evaluation document includes:

- **Need brief:** problem, success criteria, constraints
- **Build vs buy decision:** with rationale
- **Shortlist:** 2-4 finalists with brief description
- **Scorecard:** filled out per finalist, or state the gap per the data-availability rule
- **Demo and trial notes:** what was learned
- **Security and compliance summary:** findings per finalist
- **Reference call notes:** what customers said
- **Recommendation:** which vendor, with rationale
- **Negotiated terms:** what was agreed
- **Rollout plan:** onboarding, training, migration
- **Renewal calendar:** with notice deadline

---

## If required data is unavailable

This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer.

---

## Reference files

- [`references/evaluation-rubric.md`](references/evaluation-rubric.md) - Scoring template with weighted dimensions, 1-5 scale criteria for each dimension, and a worked vendor-comparison example.

© rampstackco · MIT · rampstackco/claude-skills

Similar skills

All skills for Notes, tasks and projects →

From the same set102

The whole set →
seo-content-audit seo-content-audit analyzes all pages on a site to score and categorize each: keep, update, merge, redirect, or delete. Helps diagnose traffic drops caused by content decay and resolve keyword cannibalization. CX Codex +1 300installs journey-mapping The journey-mapping skill creates customer journey maps and service blueprints that visualize the full user experience: touchpoints, emotions, friction, and underlying systems. CX Codex +1 300installs content-repurposing content-repurposing — a skill to transform one piece of content into multiple formats—articles, emails, posts, podcasts, video—while keeping its core value and avoiding mass-duplicated filler. CX Codex +1 298installs security-baseline security-baseline is a Claude Code skill that sets a security baseline for websites and web apps. It activates for HTTPS, security headers, CSP, secrets planning, and pre-launch reviews. CX Codex +1 297installs vertical-site-conventions vertical-site-conventions is a Claude Code skill that shapes pages around the layout and merchandising conventions of a site’s category. It activates for new site builds or when a technically sound page feels generic or out of place. CX Codex +1 294installs seo-rank-tracking seo-rank-tracking structures rank tracking projects using Ahrefs MCP data, segmenting keywords into four buckets with clear baseline metrics and alert rules. CX Codex +1 294installs okr-design okr-design — a skill for writing outcome-based OKRs, choosing useful key results, and correcting weak scoring habits. Use it for quarterly planning or an OKR reset. CX Codex +1 293installs seo-content-gap-audit seo-content-gap-audit identifies topics your competitors rank for but you don't, and surfaces pages losing traction. Powered by Ahrefs MCP data, it builds a roadmap for what to create, update, or remove. CX Codex +1 293installs

Project sponsors

Companies that keep this analytics open