Skip to content
reasoning-analogical logo

Analogical Reasoning

reasoning-analogical

Transfer knowledge from source domains to novel target situations through structural mapping. Use when facing new markets, products, or situations where past experience provides relevant patterns. Produces adapted solutions with explicit mappings and context adjustments.

aiskillstore/marketplace0installs430stars

SKILL.md

Full skill instructions

Analogical Reasoning

Transfer structured knowledge across domains. The logic of pattern recognition and adaptation.

Type Signature

Analogical : Source → StructuralMap → Target → Adaptation

Where:
  Source        : PriorExperience × Relevance → SourceDomain
  StructuralMap : SourceDomain → (Objects × Relations × Constraints)
  Target        : StructuralMap × NewContext → MappedStructure  
  Adaptation    : MappedStructure × ContextDifferences → AdaptedSolution

When to Use

Use analogical when:

  • Entering new market with experience in similar markets
  • Building new product with experience in similar products
  • Facing novel situation with structural similarity to past cases
  • Need to transfer playbooks across contexts
  • "This is like..." patterns in thinking

Don't use when:

  • Cause-effect chain is known → Use Causal
  • Need to explain observation → Use Abductive
  • Competing positions to resolve → Use Dialectical

Four-Stage Process

Stage 1: Source Retrieval

Purpose: Identify relevant prior experience with documented outcomes.

Source Selection Criteria:

CriterionQuestionWeight
Structural similaritySame type of problem/​situation?0.35
Outcome documentedDo we know what happened?0.25
RecencyHow recent is the experience?0.15
Success levelDid the approach work?0.15
Context overlapSimilar constraints/​resources?0.10

Source Retrieval Process:

retrieval:
  query: "Entering B2B marketplace vertical"
  
  candidates:
    - source: "Shopify DTC launch (2024)"
      similarity: 0.75
      outcome: "Validated in 6 months, $200K ARR"
      success: high
      
    - source: "Fashion brand pilot (2023)"
      similarity: 0.60
      outcome: "Slow start, pivoted twice"
      success: medium
      
    - source: "Enterprise SDK launch (2024)"
      similarity: 0.50
      outcome: "$400K first deal, strong pipeline"
      success: high
      
  selected: "Shopify DTC launch"
  reason: "Highest structural similarity (platform integration, 
           API-first, self-serve onboarding)"

Output:

source:
  case: "Shopify DTC launch"
  domain: "E-commerce platform integration"
  timeframe: "Q1-Q2 2024"
  outcome: 
    result: "success"
    metrics: "$200K ARR, 50 merchants, 6-month validation"
  key_factors:
    - "Strong app store presence"
    - "Self-serve onboarding"
    - "Integration-first positioning"
  documented_in: "threads/​operations/​shopify-dtc-launch/"

Stage 2: Structural Mapping

Purpose: Extract transferable structure from source domain.

Mapping Components:

ComponentSource ExampleAbstracted
ObjectsShopify merchantsPlatform users
RelationsMerchant → App → CustomerUser → Integration → End-user
ConstraintsApp store rulesPlatform policies
MechanismsApp store discovery → trial → purchaseDiscovery → trial → convert
Success factorsReviews, featured placementSocial proof, visibility

Structural Map:

structure:
  objects:
    - User: "Entity adopting our solution"
    - Platform: "Ecosystem we integrate with"
    - EndUser: "Final beneficiary of solution"
    - Solution: "Our product/​integration"
    
  relations:
    - Platform ⊃ Marketplace: "Platform has discovery mechanism"
    - User → Solution: "User adopts solution"
    - Solution → EndUser: "Solution serves end users"
    - EndUser feedback → User: "Value demonstration"
    
  mechanisms:
    acquisition:
      - "Platform marketplace discovery"
      - "Peer recommendations"
      - "Content marketing to users"
    activation:
      - "Self-serve trial"
      - "Quick time-to-value"
      - "Integration simplicity"
    retention:
      - "Embedded in workflow"
      - "Switching cost creation"
      - "Continuous value delivery"
      
  constraints:
    - "Platform approval required"
    - "Platform policies must be followed"
    - "Revenue share with platform"
    
  success_factors:
    - "Marketplace ranking/​visibility"
    - "User reviews/​ratings"
    - "Platform relationship quality"

Stage 3: Target Application

Purpose: Map structure to new context, identifying what transfers and what doesn't.

Target Context:

target:
  domain: "B2B marketplace integration"
  platform: "Faire wholesale marketplace"
  user: "Wholesale brands"
  end_user: "Retailers"
  goal: "Return reduction for wholesale fashion"

Mapping Execution:

mapping:
  objects:
    Platform: "Shopify" → "Faire"
    User: "DTC merchant" → "Wholesale brand"
    EndUser: "Consumer" → "Retailer"
    Solution: "Fit recommendation app" → "Wholesale sizing tool"
    
  relations:
    preserved:
      - "Platform marketplace discovery" (Faire has app marketplace)
      - "User adopts solution" (brands install integrations)
      - "Value to end user" (retailers get better sizing)
      
    modified:
      - "Self-serve trial" → "Account executive assisted"
        reason: "B2B decision process differs"
      - "Individual purchase" → "Contract-based"
        reason: "Wholesale pricing models"
        
    broken:
      - "App store reviews drive adoption"
        reason: "Faire marketplace less review-driven"
        replacement: "Case studies and referrals"
        
  mechanisms:
    acquisition:
      transfers: "Platform marketplace presence"
      adapts: "Content marketing → Trade show presence"
      new: "Wholesale buyer referral program"
      
    activation:
      transfers: "Integration simplicity"
      adapts: "Self-serve → Assisted onboarding"
      new: "Pilot with single retail partner"
      
    retention:
      transfers: "Embedded in workflow"
      transfers: "Value demonstration"
      adapts: "Individual metrics → Fleet metrics"

Stage 4: Adaptation

Purpose: Produce concrete plan adjusted for context differences.

Context Differences Analysis:

differences:
  critical:
    - name: "Decision process"
      source: "Individual merchant, fast"
      target: "Buying committee, slow"
      adaptation: "Add sales support, longer cycle expectations"
      
    - name: "Value demonstration"
      source: "Per-order metrics visible"
      target: "Aggregate across retailers"
      adaptation: "Build analytics dashboard for brands"
      
  moderate:
    - name: "Pricing model"
      source: "Per-store subscription"
      target: "Volume-based or percentage"
      adaptation: "Explore usage-based pricing"
      
  minor:
    - name: "Technical integration"
      source: "Shopify API"
      target: "Faire API"
      adaptation: "Standard integration work"

Adapted Solution:

adaptation:
  strategy: "Platform-assisted B2B wholesale launch"
  
  what_transfers:
    - "Integration-first positioning"
    - "Platform relationship investment"
    - "Quick time-to-value focus"
    - "Embedded workflow stickiness"
    
  what_adapts:
    - "Self-serve → Assisted onboarding with demo"
    - "App store discovery → Trade shows + referrals"
    - "Individual reviews → Case studies"
    - "Per-order metrics → Brand-level analytics"
    
  what's_new:
    - "Sales motion for wholesale buyers"
    - "Multi-retailer aggregation features"
    - "B2B pricing model (volume-based)"
    
  execution_plan:
    phase_1: "Platform partnership + 3 pilot brands"
    phase_2: "Case study development + trade show presence"
    phase_3: "Scale via referrals + platform promotion"
    
  expected_timeline: "9-12 months (vs 6 months for DTC)"
  reason: "B2B sales cycle longer, relationship-building required"
  
  confidence: 0.70
  uncertainty:
    - "Faire marketplace dynamics unknown"
    - "Wholesale brand decision process may vary"
    - "Volume-based pricing acceptance unclear"

Quality Gates

GateRequirementFailure Action
Source qualityDocumented outcome with metricsFind better source
Structural clarity≥3 objects, ≥3 relations explicitComplete mapping
Mapping coverageAll source elements mapped or marked brokenComplete mapping
Adaptation specificityConcrete actions, not abstractAdd specificity
Confidence threshold≥0.6 confidenceFlag high uncertainty

Common Failure Modes

FailureSymptomFix
Surface similarityMapped by superficial features, not structureFocus on relations, not objects
Over-transferAssume everything appliesExplicitly check each element
Under-adaptationCopy-paste without adjustmentForce context difference analysis
Single sourceOnly one analogy consideredRetrieve multiple candidates

Output Contract

analogical_output:
  source:
    case: string
    domain: string
    outcome: {result: string, metrics: string}
    thread_ref: optional<string>
    
  mapping:
    objects: {source_name: target_name}
    relations:
      preserved: [string]
      modified: [{from: string, to: string, reason: string}]
      broken: [{relation: string, reason: string, replacement: string}]
      
  adaptation:
    transfers: [string]      # What applies directly
    adapts: [string]         # What needs modification
    new: [string]            # What's genuinely new
    
  plan:
    phases: [{name: string, actions: [string]}]
    timeline: string
    milestones: [string]
    
  confidence: float  # 0.0-1.0
  uncertainty: [string]
  
  next:
    suggested_mode: ReasoningMode  # Usually causal
    canvas_refs: [string]          # Assumptions being tested
    
  trace:
    sources_considered: int
    mapping_coverage: float  # % of source elements mapped
    duration_ms: int

Example Execution

Context: "Expand to home goods vertical (currently in fashion)"

Stage 1 - Source Retrieval:

Selected: Fashion DTC success (highest similarity)
Alternatives considered: 
  - Beauty vertical (rejected: different return dynamics)
  - B2B wholesale (rejected: different buyer)

Stage 2 - Structural Mapping:

Objects: Fashion brand → Home goods brand
Relations: 
  - Fit concern → Dimension/​space concern
  - Style matching → Aesthetic matching
  - Return reason: fit → Return reason: scale/​compatibility
Mechanisms:
  - Visual AI → Transfer (image analysis)
  - Size recommendation → Adapt (dimension recommendation)
  - Color matching → Transfer (palette matching)

Stage 3 - Target Application:

Preserved: Visual AI core, recommendation engine, integration model
Modified: Fit algorithm → Dimension/​space algorithm
Broken: Body measurement input → Room/​space measurement input

Stage 4 - Adaptation:

Plan:
  Phase 1: Partner with 2 home goods DTC brands (furniture focus)
  Phase 2: Adapt algorithm for dimension-based recommendations
  Phase 3: Develop room visualization feature (new capability)
  
Timeline: 4-6 months (faster than fashion - simpler measurements)
Confidence: 0.75
Key uncertainty: Room visualization technical complexity

More skills from aiskillstore

docx logo
aiskillstore/marketplace

docx

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

430 216
View
agent-development logo
aiskillstore/marketplace

agent-development

This handles everything around building autonomous agents for Claude Code plugins.

430 197
View
doc-coauthoring logo
aiskillstore/marketplace

doc-coauthoring

Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.

430 196
View
skill-development logo
aiskillstore/marketplace

skill-development

This is the meta-skill for building skills themselves.

430 196
View
canvas-design logo
aiskillstore/marketplace

canvas-design

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

430 193
View
webapp-testing logo
aiskillstore/marketplace

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

430 191
View
hook-development logo
aiskillstore/marketplace

hook-development

Helps you build event-driven automation for Claude Code using hooks that trigger on tool use, session events, and stop conditions.

430 187
View
algorithmic-art logo
aiskillstore/marketplace

algorithmic-art

Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.

430 185
View
command-development logo
aiskillstore/marketplace

command-development

Shows Claude Code how to build slash commands from markdown files, covering the YAML frontmatter options, dynamic arguments with $1/$2...

430 185
View
plugin-structure logo
aiskillstore/marketplace

plugin-structure

This is your reference when scaffolding Claude Code plugins or figuring out why components aren't loading.

430 183
View
skill-installer logo
aiskillstore/marketplace

skill-installer

Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).

430 180
View
web-artifacts-builder logo
aiskillstore/marketplace

web-artifacts-builder

Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.

430 177
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View