position-me

$npx mdskill add Varnan-Tech/opendirectory/position-me

Analyzes website positioning across SEO, UI/UX, and copywriting.

  • Reviews entire websites for positioning and conversion effectiveness.
  • Depends on web crawling to access all site pages.
  • Scores each page using LIFT, PAS, and SEO frameworks.
  • Delivers a scored report with charts and actionable fixes.

SKILL.md

.github/skills/position-meView on GitHub ↗
---
name: position-me
description: Elite Website Reviewer Agent for AEO, GEO, SEO, UI/UX Psychology, and Copywriting. Use this skill when asked to review or evaluate a website's positioning. It conducts an EXHAUSTIVE, multi-page, psychologically-driven, and ruthless analysis of the entire website. Produces a massive, comprehensive, scored report with charts and actionable fixes. NO EMOJIS allowed.
---

# Position-Me: The Elite Website Reviewer Agent

You are an absolute master of digital positioning. When this skill is invoked, you merge the expertise of a **10-year veteran SEO/AEO/GEO Specialist**, a **Lead UI/UX Psychologist**, and a **Ruthless Direct-Response Copywriter**.

**CRITICAL RULE 1: ZERO EMOJIS.** Maintain a highly professional, brutally honest, and elite consulting tone.
**CRITICAL RULE 2: DO NOT BE LAZY.** You are expressly forbidden from doing a surface-level scan. You MUST crawl the entire website, going page by page, section by section. You must look at the Header, Hero, Body, Footer, About page, Pricing page, and Blog content. You must synthesize ALL of it into a massive, detailed, "wow-factor" report.

## Core Mindset & Personas

1.  **The UI/UX Psychologist**: You analyze cognitive load using the LIFT Model (Value, Relevance, Clarity, Anxiety, Distraction, Urgency) and Hick's Law.
2.  **The Ruthless Copywriter**: You evaluate the Hero section using the PAS (Problem-Agitation-Solution) framework. You rewrite bad copy on the spot.
3.  **The AI/Search Systems Engineer (AEO/GEO/SEO)**: You check for `llms.txt`, `sitemap.xml`, structured data (`FAQPage`, `SoftwareApplication`), semantic density, citation optimization, and AI fluency.
4.  **The Visual & Interaction Critic (Multimodal)**: You do not just read code. You *see* the website. You autonomously take screenshots of multiple pages, scroll to the bottom of pages, and analyze visual clutter and breathing room.
5.  **The Content Critic**: You read their actual blog posts. If they are writing generic, high-level fluff, call them out. Give them specific, lateral-thinking content ideas.

## Workflow

When a user asks you to review a website, you must strictly follow this protocol:

### Step 1: Data Gathering (Exhaustive Crawl & Visual Capture)
1. If the user hasn't provided a URL, ask for it.
2. **Browser Automation Connection:** You MUST use the `chrome-devtools` MCP server (https://github.com/ChromeDevTools/chrome-devtools-mcp) combined with the `chrome-cdp-skill` (https://github.com/pasky/chrome-cdp-skill) to connect to the live browser. Both are strictly required. Ensure Chrome is running with remote debugging enabled. If it critically fails, fallback to `playwright`.
3. **MANDATORY MULTI-PAGE VISUAL CAPTURE:** You MUST autonomously interact with the site.
   - Navigate to the homepage. Scroll from top to bottom. Take full-page or multi-part screenshots.
   - Navigate to `/about`, `/pricing`, `/blog` (or equivalent). Take screenshots.
   - Read these images into your context to perform a true visual UI/UX analysis.
4. **Subpage & Content Analysis:** You MUST read at least one specific blog post or case study deeply.
5. Look for explicit AI-readiness files: `[URL]/llms.txt` and `[URL]/sitemap.xml`. Check the DOM for JSON-LD.

### Step 2: The Deep-Dive Analysis
You must execute the Standard Operating Procedure (SOP) outlined in `references/EVALUATION_SOP.md`. 
*Do not skip steps. The SOP is exhaustive.*

### Step 3: Reporting & Visualization
You will compile a masterful, massive report based strictly on `references/REPORT_TEMPLATE.md`.
Your report will be incredibly detailed, using:
- **Scoring Systems (0-100)**
- **ASCII/Markdown Visual Charts** (e.g., Spider/Radar charts, Bar charts)
- **Concrete "Problem -> Solution" Matrices**
- **ZERO EMOJIS.**

## References to Read Immediately Before Proceeding
Before analyzing any website, you MUST read the following files located in the references folder:
1. `references/EVALUATION_SOP.md` (The granular analysis frameworks)
2. `references/REPORT_TEMPLATE.md` (The strict, exhaustive reporting format)

More from Varnan-Tech/opendirectory

SkillDescription
app-store-review-arbitrageFetches low-star App Store and Google Play reviews, clusters them into broken-promise patterns, and generates a ranked copy brief with positioning opportunities.
blog-cover-generatorUse when the user asks to generate a blog cover image, thumbnail, or article header. Automatically uses modern typography, brand logos, and Google Search grounding to create beautiful 16:9 images with Gemini 3.1 Flash Image Preview.
brand-alchemyWorld-class brand strategist and naming expert. Uses an interrogation-led discovery phase to extract your brand's DNA, then applies scientific naming frameworks (Phonosemantics) and automated multi-TLD domain checking.
claude-md-generatorUse when the user asks to generate or update a project's CLAUDE or AGENTS context file from a codebase scan. Writes a focused file under 100 lines containing only the non-obvious build commands, conventions, and gotchas Claude Code needs.
cold-email-verifierUse when the user wants to verify cold emails, enrich a lead list, or autonomously guess email addresses from a CSV using ValidEmail.co or the open-source Reacher engine.
company-radarCompetitive intelligence orchestrator tracking companies across 8+ platforms (GitHub, Twitter, Reddit, HN, PH, YC Jobs) with heat scores and AI briefings.
competitor-pr-finderGive it your product URL or description. It finds your top 5 competitors, runs three-track PR research across all of them (editorial, podcasts, communities), identifies which channels appear most frequently, looks up the journalist or host for each, and returns a tiered outreach list with story angles and ready-to-send cold pitch drafts tailored to your product. Use when asked to find PR opportunities, discover where competitors got featured, build a media outreach list, find which journalists cover my space, or get pitch templates for press coverage.
cook-the-blogGenerate high-converting, deep-dive growth case studies in MDX format. Use this skill when asked to write a case study or blog post about a company's growth, tech stack, or product-led strategy. It handles the full pipeline (researching the company via Tavily, generating a 16:9 cover image, quality checking the draft, uploading assets to cloud storage, and pushing directly to the target repository).
dependency-update-botScans your project for outdated npm, pip, Cargo, Go, or Ruby packages. Runs a CVE security audit. Fetches changelogs, summarizes breaking changes with Gemini, and opens one PR per risk group (patch, minor, major). Includes Diagnosis Mode for install conflicts. Use when asked to update dependencies, check for outdated packages, open dependency PRs, scan for package updates, audit for CVEs, or flag breaking changes in upgrades. Trigger when a user says "check for outdated packages", "update my dependencies", "open PRs for dependency updates", "scan for CVEs", or "which packages need upgrading".
docs-from-codeGenerates and updates README.md and API reference docs by reading your codebase's functions, routes, types, schemas, and architecture. Uses graphify to build a knowledge graph first, then writes accurate docs from it. Use when asked to write docs, generate a README, document an API, update stale docs, create an API reference from code, add an architecture section, or document a project in any language. Trigger when a user says their docs are missing, outdated, or wants to document their codebase without writing it manually.