Expert Validator

Name: Expert Validator
Author: shipshitdev

shipshitdev/library

106 installs
31 repo stars
Updated August 2, 2026
shipshitdev/library

Run a rigorous expert-level review of architecture, code, and delivery readiness before merge or release when you need senior judgment beyond linting.

About

The expert-validator skill applies senior engineering judgment to assess whether code, architecture, and delivery artifacts meet production standards before shipping. It goes beyond automated checks to challenge design choices, edge cases, and maintainability so teams avoid costly post-release fixes.

Senior-level architecture critique
Pre-release quality gate
Cross-stack implementation review
Risk and regression detection
Actionable fix recommendations

Expert Validator by the numbers

106 all-time installs (skills.sh)
Ranked #440 of 1,352 Code Review & Quality skills by installs in the Skillselion catalog
Data as of Aug 3, 2026 (Skillselion catalog sync)

npx skills add https://github.com/shipshitdev/library --skill expert-validator

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/shipshitdev/library/expert-validator.svg)](https://skillselion.com/skills/shipshitdev/library/expert-validator)

Installs	106
repo stars	★ 31
Last updated	August 2, 2026
Repository	shipshitdev/library ↗

What it does

Run a rigorous expert-level review of architecture, code, and delivery readiness before merge or release when you need senior judgment beyond linting.

Files

SKILL.mdMarkdownGitHub ↗

Expert Validator - Expert Secrets Scorecard

Assess positioning, authority, and messaging against Expert Secrets principles. Expose weak positioning that makes people look like everyone else.

Brunson's Principle: "You don't need to be the most qualified—you need to be the most positioned."

When This Activates

User asks "validate my positioning"
User asks "is my messaging right"
User says "I sound like everyone else"
User asks "how do I build authority"
User asks "what's my angle"

The Framework

Attractive Character → Epiphany Bridge → Big Domino → New Opportunity

Scoring Dimensions

Dimension	Weight	What It Measures
Attractive Character	2x	Is there a compelling persona/story?
Origin Story	1.5x	Is there a powerful epiphany bridge?
Big Domino	2x	Is there one core belief to shift?
New Opportunity	1.5x	Is it framed as new vs. improvement?
Authority Signals	1x	Are credentials/proof established?
Differentiation	1x	Do they stand out from competitors?

Max Score: 100 points

Rating Scale

Score	Rating	Verdict
85-100	Expert Positioned	Refine and scale
70-84	Good Foundation	Strengthen weak areas
55-69	Needs Work	Clarify before scaling
40-54	Commodity Zone	Major repositioning needed
0-39	Invisible	Start from scratch

Quick Reference

Attractive Character Types

Type	Description	Example
Leader	"Follow me, I'll show you"	Coaches, gurus
Adventurer	"Join me on this journey"	Explorers, testers
Reporter	"I researched this for you"	Curators, analysts
Reluctant Hero	"I didn't want to, but..."	Accidental experts

Big Domino Formula

"If I can get them to believe [ONE THING], then all other objections become irrelevant."

New Opportunity vs. Improvement

Improvement (Weak)	New Opportunity (Strong)
"Better marketing"	"A new way to get customers"
"Faster results"	"A different approach entirely"
"We're like X but better"	"Skip the old method"

Integration

Skill	When to Use
`expert-architect`	Build positioning from scratch
`copy-validator`	Validate positioning translates to copy
`offer-validator`	Validate offer matches positioning

---

For detailed scoring criteria, output templates, and complete examples: references/full-guide.md

{
  "name": "expert-validator",
  "version": "1.0.0",
  "description": "Use this skill when users need to validate their positioning, authority, or messaging strategy. Activates for 'validate my positioning,' 'is my messaging right,' 'how do I position myself,' or when assessing expert authority and attractive character.",
  "author": {
    "name": "Ship Shit Dev",
    "email": "hello@shipshit.dev",
    "url": "https://github.com/shipshitdev"
  },
  "license": "MIT",
  "skills": "."
}

Expert Validator - Full Guide

Complete guide to validating positioning against Expert Secrets principles.

Step 1: Gather Positioning

Ask the user:

Tell me about your positioning:

1. Who are you and what do you help people do?

2. What's your background/origin story?

3. What makes you different from competitors?

4. What's the main thing you want people to believe?

5. How do you describe what you offer?

6. Share any positioning materials (bio, about page, pitch)

Scoring Criteria

Attractive Character (0-10, Weight: 2x)

Score	Description
9-10	Vivid, memorable character with clear archetype and personality
7-8	Good character presence, relatable, some personality
5-6	Character exists but generic, not distinctive
3-4	Minimal character, faceless brand
0-2	No character, purely transactional

Attractive Character Types:

Type	Description	Example
Leader	"Follow me, I'll show you"	Coaches, gurus
Adventurer	"Join me on this journey"	Explorers, testers
Reporter	"I researched this for you"	Curators, analysts
Reluctant Hero	"I didn't want to, but..."	Accidental experts

Red Flags:

"We help businesses..." (no character)
Generic bio with only credentials
No personality in communication
Could swap name with any competitor

Origin Story (0-10, Weight: 1.5x)

Score	Description
9-10	Powerful origin story with clear epiphany, emotionally resonant
7-8	Good story, clear transformation, connects to offer
5-6	Story exists but weak or disconnected
3-4	Minimal story, mostly facts/credentials
0-2	No origin story

Epiphany Bridge Structure:

1. Backstory → "I used to be..."
2. Wall → "Then I hit..."
3. Epiphany → "That's when I realized..."
4. Plan → "So I..."
5. Success → "And now..."
6. Transformation → "I became..."

Big Domino (0-10, Weight: 2x)

Score	Description
9-10	Crystal clear Big Domino, explicitly stated, everything ladders to it
7-8	Big Domino exists, mostly clear, some alignment
5-6	Implied domino but not explicit
3-4	Multiple competing beliefs, no clear domino
0-2	No Big Domino, scattered messaging

Big Domino Formula:

"If I can get them to believe [ONE THING], then all other objections and concerns become irrelevant and they have to [DESIRED ACTION]."

Examples:

"If I can get them to believe funnels work better than websites..."
"If I can get them to believe speed matters more than perfection..."
"If I can get them to believe they can code with AI..."

New Opportunity (0-10, Weight: 1.5x)

Score	Description
9-10	Clear new opportunity, new mechanism, switch from old way
7-8	Positioned as new, some differentiation
5-6	Mix of new and improvement messaging
3-4	Mostly improvement positioning
0-2	Pure improvement, "better X" positioning

New Opportunity vs. Improvement:

Improvement (Weak)	New Opportunity (Strong)
"Better marketing"	"A new way to get customers"
"Faster results"	"A different approach entirely"
"More features"	"Skip the old method"
"Upgraded version"	"Replace what you're doing"

Authority Signals (0-10, Weight: 1x)

Score	Description
9-10	Strong, relevant authority with multiple proof types
7-8	Good authority signals, believable
5-6	Some authority, could be stronger
3-4	Weak authority, generic claims
0-2	No authority signals

Authority Types:

Results: "Helped X people achieve Y"
Credentials: Certifications, education
Media: Publications, features
Association: Worked with known brands
Social: Followers, subscribers, testimonials

Differentiation (0-10, Weight: 1x)

Score	Description
9-10	Completely distinctive, own category, unmistakable
7-8	Clear differentiation, memorable
5-6	Some differentiation but not strong
3-4	Generic, could be anyone
0-2	Commodity, indistinguishable

Differentiation Test:

If you removed the name, could this be any competitor?

If yes, differentiation is weak.

Score Calculation

Attractive Character × 2 = ___
Origin Story × 1.5 = ___
Big Domino × 2 = ___
New Opportunity × 1.5 = ___
Authority Signals × 1 = ___
Differentiation × 1 = ___
─────────────────────────
TOTAL = ___ / 100

Output Template

# Expert Validation: [Name/Brand]

## Quick Rating

| Rating | Score | Verdict |
|--------|-------|---------|
| [Rating] | XX/100 | [One-line summary] |

## Score Breakdown

| Dimension | Raw Score | Weight | Weighted Score | Status |
|-----------|-----------|--------|----------------|--------|
| Attractive Character | X/10 | ×2 | XX/20 | [Build/Develop/Strong] |
| Origin Story | X/10 | ×1.5 | XX/15 | [Create/Improve/Strong] |
| Big Domino | X/10 | ×2 | XX/20 | [Define/Clarify/Strong] |
| New Opportunity | X/10 | ×1.5 | XX/15 | [Reframe/Strengthen/Strong] |
| Authority Signals | X/10 | ×1 | XX/10 | [Build/Add/Strong] |
| Differentiation | X/10 | ×1 | XX/10 | [Differentiate/Sharpen/Strong] |
| **TOTAL** | | | **XX/100** | |

## Detailed Assessment

### Attractive Character: X/10
**Current:** [Their character]
**Missing:** [What's lacking]
**Character Type:** [Leader/Adventurer/Reporter/Reluctant Hero]

### Big Domino: X/10
**Current Belief:** [What they're trying to shift]
**Recommended Domino:**
> "If I can get them to believe [X], then [Y]"

### New Opportunity: X/10
**Current Framing:** [Improvement or New Opportunity?]
**Reframe As:**
> [New opportunity positioning]

## Priority Fixes

1. **[Dimension]:** [Specific fix]
2. **[Dimension]:** [Specific fix]
3. **[Dimension]:** [Specific fix]