yao-positioning-skill

Generate evidence-based positioning reports with competitor research, advantage diagnosis, and offline HTML output.

1.3k|146|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/yaojingang/yao-open-skills --skill yao-positioning-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: yao-positioning-skill
Source: https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-positioning-skill
Command: npx skills add https://github.com/yaojingang/yao-open-skills --skill yao-positioning-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

It turns vague positioning requests for personal IPs, courses, products, services, brands, or companies into an auditable decision chain, preventing unsupported differentiation claims and unverified competitor conclusions.

Core Features & Use Cases

  • Readiness-gated intake: Accepts guided Q&A, file attachments, or URLs, normalizes them into a schema-validated intake brief, and blocks research until six minimum information requirements are met.
  • Evidence-graded research: Studies five competitor types, user demand, and D6 advantages with source credibility checks covering authority, directness, freshness, independence, and market fit.
  • Auditable report bundle: Produces an offline HTML report with 12 ECharts visualizations, a structured JSON fact source, and a Markdown fallback, all validated and reviewed by scripts.
  • Use Case: A course creator provides their website and student interviews; the skill researches competitors, diagnoses provable advantages, compares 2-3 positioning options, and delivers a recommended one-sentence positioning with risks and a validation plan.

Quick Start

Ask the agent to create a positioning report for your product or personal brand, then answer its intake questions or provide your website URL and supporting materials.

Frequently Asked Questions about yao-positioning-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a positioning report for my product or personal brand?

Provide your materials through guided Q&A, file attachments, or website URLs. The skill normalizes inputs into an intake brief, verifies six readiness requirements, then researches competitors and advantages before generating HTML, JSON, and Markdown reports.

What inputs does a positioning analysis tool need before starting research?

It requires six items: an identifiable subject, a clear decision objective, a describable offer, market boundaries with region and language, a target user hypothesis, and at least one verifiable source such as text, a file, or an official URL.

Can the positioning report be generated without internet access?

Yes, it supports a local evidence mode when external research is unavailable. In that mode it only uses user-provided materials and outputs a supplementary evidence checklist instead of verified competitor claims.

Does the skill require third-party Python packages?

No, the validation, rendering, and review scripts run on the Python standard library only. The HTML report uses a vendored copy of Apache ECharts 6.1.0, so no CDN or network requests are needed.

When should I not use this positioning skill?

Avoid it for slogan-only copywriting, generic marketing ideas, standalone market research without a positioning recommendation, or brand knowledge-base construction. It is designed for evidence-backed positioning decisions, not creative taglines.

Why does the report show insufficient evidence instead of a recommendation?

The skill enforces diagnostic and recommendation gates. When demand, competitor, or advantage evidence is missing, it outputs only preliminary observations and a supplementary evidence plan rather than fabricating differentiation claims.