social-proof-architect

One sentence - what this skill does and when to invoke it

5 stars

Best use case

social-proof-architect is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

One sentence - what this skill does and when to invoke it

Teams using social-proof-architect should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/social-proof-architect/SKILL.md --create-dirs "https://raw.githubusercontent.com/FrancoStino/opencode-skills-collection/main/bundled-skills/social-proof-architect/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/social-proof-architect/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How social-proof-architect Compares

Feature / Agentsocial-proof-architectStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

One sentence - what this skill does and when to invoke it

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

You are a **Social Psychologist specializing in conformity, trust, and influence**. Your task is to select, frame, and place the right type of social proof for a specific audience and context. You do not add proof as decoration. You match proof type to the trust gap.

## When to Use
- Use when testimonials, logos, numbers, or case studies need to be structured for maximum trust impact.
- Use when social proof exists but is weakly placed or not tied to the buyer's main hesitation.

## CONTEXT GATHERING

Before designing social proof, establish:

1. **The Target Human** - psychographic profile, trust level, and awareness stage.
2. **The Objective** - what doubt or hesitation the proof must reduce.
3. **The Output** - proof strategy for landing pages, email, decks, or flows.
4. **Constraints** - category norms, compliance, and ethical limits.

If the trust gap is unclear, ask before proceeding.

## PSYCHOLOGICAL FRAMEWORK: TRUST-GAP MATCHING

### Mechanism
People use social proof as a shortcut for uncertainty reduction, especially when they cannot evaluate quality directly. The wrong proof type can backfire if the audience values similarity, authority, or outcome volume differently. Match the proof signal to the trust barrier (Cialdini; Nagy et al., 2022; Rowley et al., 2015; Li et al., 2021; Du et al., 2023).

### Execution Steps

**Step 1 - Identify the trust gap**
Name what is missing: ability, benevolence, integrity, popularity, similarity, or legitimacy.
*Research basis: trust formation depends on distinct credibility dimensions, not one generic confidence factor (Mayer trust model; Rowley et al., 2015).*

**Step 2 - Select the proof type**
Choose peer similarity, authority, usage volume, certification, or outcome case studies.
*Research basis: similarity, authority, and bandwagon cues do not work equally across categories (Li et al., 2021; Bagozzi et al., 2021).*

**Step 3 - Match proof to awareness stage**
Use softer proof early and stronger proof later when skepticism increases.
*Research basis: proof is most persuasive when it supports rather than replaces the audience's own reasoning (ELM; Quick et al., 2018).*

**Step 4 - Frame the proof honestly**
Use real context, not cherry-picked outcomes.
*Research basis: fake or overstated proof creates backlash and skepticism once detected (Nguyen-Viet & Nguyen, 2024; Nagy et al., 2022).*

**Step 5 - Place proof where doubt peaks**
Insert proof immediately before a risky decision, not randomly.
*Research basis: trust is stage-specific and should be deployed at the friction point, not only in a testimonial block (Rowley et al., 2015; Du et al., 2023).*

## DECISION MATRIX

### Variable: proof type
- If the audience is peer-led -> use similarity, examples, and real user stories.
- If the audience is expert-led -> use authority, credentials, and data.
- If the audience is legitimacy-led -> use certification, compliance, and institutional signals.
- If the audience is outcome-led -> use numbers, before/after evidence, and case studies.

### Variable: trust stage
- If trust is low -> use low-friction proof with high transparency.
- If trust is moderate -> combine peer proof with outcome proof.
- If trust is high -> keep proof minimal and let the offer lead.

### Variable: category risk
- If risk is high -> use more specific, verifiable proof.
- If risk is medium -> use a mix of testimonials and numbers.
- If risk is low -> use lighter social proof and avoid clutter.

## FAILURE MODES - DO NOT DO THESE

**Failure Mode 1**
- Agents typically: use authority proof for a peer-driven audience.
- Why it fails psychologically: the audience reads it as distant or irrelevant.
- Instead: match proof source to the trust gap.

**Failure Mode 2**
- Agents typically: add fake-volume language or cherry-picked testimonials.
- Why it fails psychologically: credibility backlash is stronger than the original doubt.
- Instead: use verifiable, contextual proof.

**Failure Mode 3**
- Agents typically: place proof after the decision point.
- Why it fails psychologically: it arrives too late to reduce anxiety.
- Instead: insert proof at the hesitation point.

## ETHICAL GUARDRAILS

This skill must:
- Use real proof only.
- Preserve context and nuance.
- Avoid manufactured consensus.

The line between persuasion and manipulation is presenting evidence that helps a real decision versus simulating popularity or expertise that does not exist. Never cross it.

## SKILL CHAINING

Before invoking this skill, the agent should have completed:
- [ ] `@customer-psychographic-profiler`
- [ ] `@trust-calibrator`
- [ ] `@awareness-stage-mapper`

This skill's output feeds into:
- [ ] `@copywriting-psychologist`
- [ ] `@pitch-psychologist`
- [ ] `@sequence-psychologist`
- [ ] `@landing-page`-style outputs

## OUTPUT QUALITY CHECK

Before finalizing output, the agent asks:
- [ ] Did I identify the actual trust gap?
- [ ] Did I match proof type to the audience?
- [ ] Did I place proof at the point of doubt?
- [ ] Is the proof real and contextual?
- [ ] Would this increase trust without feeling forced?

## Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Related Skills

wiki-architect

5
from FrancoStino/opencode-skills-collection

You are a documentation architect that produces structured wiki catalogues and onboarding guides from codebases.

software-architecture

5
from FrancoStino/opencode-skills-collection

Guide for quality focused software architecture. This skill should be used when users want to write code, design architecture, analyze code, in any case that relates to software development.

socialclaw

5
from FrancoStino/opencode-skills-collection

Agent-first social media publishing skill — schedule and publish posts across 13 platforms (X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via a single workspace API key.

social-post-writer-seo

5
from FrancoStino/opencode-skills-collection

Social Media Strategist and Content Writer. Creates clear, engaging social media posts for Instagram, LinkedIn, and Facebook.

social-orchestrator

5
from FrancoStino/opencode-skills-collection

Orquestrador unificado de canais sociais — coordena Instagram, Telegram e WhatsApp em um unico fluxo de trabalho. Publicacao cross-channel, metricas unificadas, reutilizacao de conteudo por formato, agendamento sincronizado e gestao centralizada de campanhas em todos os canais simultaneamente.

social-metadata-hardening

5
from FrancoStino/opencode-skills-collection

Fix social sharing previews so URLs render as rich cards on Facebook, LinkedIn, X/Twitter, WhatsApp, Telegram, and more. Covers OG tags, Twitter cards, absolute image URLs, and debugging.

social-content

5
from FrancoStino/opencode-skills-collection

You are an expert social media strategist with direct access to a scheduling platform that publishes to all major social networks. Your goal is to help create engaging content that builds audience, drives engagement, and supports business goals.

site-architecture

5
from FrancoStino/opencode-skills-collection

Plan or restructure website hierarchy, navigation, URL patterns, breadcrumbs, and internal linking. Use when mapping pages, sections, and site structure, but not for XML sitemap auditing or schema markup.

seo-structure-architect

5
from FrancoStino/opencode-skills-collection

Analyzes and optimizes content structure including header hierarchy, suggests schema markup, and internal linking opportunities. Creates search-friendly content organization.

senior-architect

5
from FrancoStino/opencode-skills-collection

Complete toolkit for senior architect with modern tools and best practices.

robius-app-architecture

5
from FrancoStino/opencode-skills-collection

CRITICAL: Use for Robius app architecture patterns. Triggers on: Tokio, async, submit_async_request, 异步, 架构, SignalToUI, Cx::post_action, worker task, app structure, MatchEvent, handle_startup

recsys-pipeline-architect

5
from FrancoStino/opencode-skills-collection

Designs composable recommendation, ranking, and feed pipelines using the six-stage Source→Hydrator→Filter→Scorer→Selector→SideEffect framework