Agent skill

Yao Positioning Skill

by yaojingang in yaojingang/yao-open-skills

Generate evidence-aware positioning reports for personal IPs, courses, products, services, brands, or companies by combining positioning theory, course-marketing analysis, user intent, competitor…

MITAuto-check passedMarketing & SEO

Install Yao Positioning Skill

skills CLI
$ npx skills add yaojingang/yao-open-skills --skill yao-positioning-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install yaojingang/yao-open-skills yao-positioning-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/yaojingang/yao-open-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/yao-positioning-skill .claude/skills/yao-positioning-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
yao-positioning-skill
GitHub stars
1.3k
Token cost
~805 tokens
SKILL.md length
135 words
Files
42 (incl. scripts, references, assets)
Skills in repo
16
Repo updated
First seen
Licence
MIT

At a glance

Generate evidence-aware positioning reports for personal IPs, courses, products, services, brands, or companies by combining positioning theory, course-marketing analysis, user intent, competitor…

  • Works in 12 steps: 按… → 仅当校验返回 intake_ready… → 选择 local、standard 或 deep… → …
  • Users ask for 定位、差异化分析、优势分析、心智定位、品类定位、竞品定位研究、定位报告或再定位建议
  • SKILL.md covers Owned Job, Workflow, Downgrade Rules and Output Contract, plus 1 more section
  • Runs JavaScript scripts from its folder; calls python3

What it does

Yao Positioning Skill is an agent skill from yaojingang/yao-open-skills. Generate evidence-aware positioning reports for personal IPs, courses, products, services, brands, or companies by combining positioning theory, course-marketing analysis, user intent, competitor research, market demand, and verifiable advantages. Use when users ask for 定位、差异化分析、优势分析、心智定位、品类定位、竞品定位研究、定位报告或再定位建议. Do not use for slogan-only copywriting, generic marketing ideas, standalone market research without a positioning recommendation, or brand knowledge-base construction.

Its SKILL.md is about 810 tokens, which your agent loads only when the skill is triggered. The skill folder holds 44 other files, including scripts, reference files and assets (for example `README.md`, `agents/interface.yaml` and `assets/echarts.min.js`).

It sits in Marketing & SEO, covering Positioning and messaging, Competitor analysis and Copywriting. It works with Python. The repository describes itself as: OpenYao public skills collection: reusable AI assets for decision-making, business analysis, tutorials, research evidence gathering, and document generation. The licence is MIT.

When your agent uses it

  • Users ask for 定位、差异化分析、优势分析、心智定位、品类定位、竞品定位研究、定位报告或再定位建议
  • Slogan-only copywriting
  • Generic marketing ideas
  • Standalone market research without a positioning recommendation

Example prompts

  • “/yao-positioning-skill”

Requirements

  • Python 3
  • Node.js

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

  1. 按 references/intake-and-readiness-gate.md 接受问答、附件或 URL,整理符合 templates/intake-brief.schema.json 的 intake-brief.json,运行 python3…
  2. 仅当校验返回 intake_ready 才开始检索;否则停止并使用返回的缺失项与示例,每轮追问 1 至 3 个问题。开始前回显对象、目的、范围、已收资料、自述项和待核验项。
  3. 选择 local、standard 或 deep 研究模式。需要当前竞品、价格或市场事实时必须联网核验。
  4. 读取 references/theory-system.md。个人 IP 或课程任务再读 references/course-marketing-method.md。
  5. 按 references/ai-workflow.md 建立主张清单、竞争集合、研究计划和证据台账。
  6. 按 references/source-credibility-policy.md 区分事实、自述、推断、假设和建议;来源必须通过权威性、主张适配、直接性、时效性、独立性和市场适配检查。
  7. 按 references/competitor-research-method.md 研究竞争与心智位置。禁止把“未发现公开证据”写成“不存在”。
  8. 按 references/demand-and-differentiation-method.md 分析需求、市场空位和 D6 优势,执行否决规则。
  9. 通过诊断与推荐门槛后生成 2 至 3 套定位方案并压力测试,只推荐一套;不通过时只输出初步观察和补证计划。
  10. 按 references/plain-language-positioning-method.md 生成通俗的心智快照,再进入可视化报告。
  11. 先生成符合 templates/report-data.schema.json 的 JSON,再运行 python3 scripts/validate-report-data.py positioning-report-data.json。
  12. 校验通过后运行 python3 scripts/render-report.py positioning-report-data.json --out positioning-report。

What it can do on your machine

Read from SKILL.md and the folder at commit 093996e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (JavaScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Yao Positioning Skill loads about 805 tokens when it runs, and up to ~19k if it reads all its reference files. Until then it costs about 126 tokens; SKILL.md has 135 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~126
When it runs · the whole SKILL.md, loaded when a task matches
~805
With references · SKILL.md plus every file in references/, read only if the agent opens them
~19k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from yaojingang/yao-open-skills at commit 093996e, republished under its MIT licence (© yaojingang). 135 words, ~805 tokens.

Download SKILL.mdSave it as .claude/skills/yao-positioning-skill/SKILL.md (or your agent's skills folder). This skill also uses 41 other files; get the full folder from GitHub.
name
yao-positioning-skill
description
Generate evidence-aware positioning reports for personal IPs, courses, products, services, brands, or companies by combining positioning theory, course-marketing analysis, user intent, competitor research, market demand, and verifiable advantages. Use when users ask for 定位、差异化分析、优势分析、心智定位、品类定位、竞品定位研究、定位报告或再定位建议. Do not use for slogan-only copywriting, generic marketing ideas, standalone market research without a positioning recommendation, or brand knowledge-base construction.
metadata.author
Yao Team

定位分析与报告

Owned Job

  • 为个人、课程、产品、服务或品牌生成定位报告。
  • 研究五类竞争参照。
  • 比较 2 至 3 套方案并推荐或降级。

Workflow

  1. 按 references/intake-and-readiness-gate.md 接受问答、附件或 URL,整理符合 templates/intake-brief.schema.json 的 intake-brief.json,运行 python3 scripts/validate-intake.py intake-brief.json。
  2. 仅当校验返回 intake_ready 才开始检索;否则停止并使用返回的缺失项与示例,每轮追问 1 至 3 个问题。开始前回显对象、目的、范围、已收资料、自述项和待核验项。
  3. 选择 local、standard 或 deep 研究模式。需要当前竞品、价格或市场事实时必须联网核验。
  4. 读取 references/theory-system.md。个人 IP 或课程任务再读 references/course-marketing-method.md。
  5. 按 references/ai-workflow.md 建立主张清单、竞争集合、研究计划和证据台账。
  6. 按 references/source-credibility-policy.md 区分事实、自述、推断、假设和建议;来源必须通过权威性、主张适配、直接性、时效性、独立性和市场适配检查。
  7. 按 references/competitor-research-method.md 研究竞争与心智位置。禁止把“未发现公开证据”写成“不存在”。
  8. 按 references/demand-and-differentiation-method.md 分析需求、市场空位和 D6 优势,执行否决规则。
  9. 通过诊断与推荐门槛后生成 2 至 3 套定位方案并压力测试,只推荐一套;不通过时只输出初步观察和补证计划。
  10. 按 references/plain-language-positioning-method.md 生成通俗的心智快照,再进入可视化报告。
  11. 先生成符合 templates/report-data.schema.json 的 JSON,再运行 python3 scripts/validate-report-data.py positioning-report-data.json。
  12. 校验通过后运行 python3 scripts/render-report.py positioning-report-data.json --out positioning-report。
  13. 运行 python3 scripts/review-report.py positioning-report,修复语义、图表、移动端、打印和跨格式回归;不得通过删证据或升级置信度消除警告。
  14. 按 references/report-contract.md 核对 HTML、JSON、Markdown 的结论、指标和引用一致性。模板或图表变更再按 references/report-review-method.md 执行三视口与 A4 PDF 栅格化审校。

Downgrade Rules

  • 研究就绪门槛未通过:只补信息,不检索竞品、不生成方案。
  • 诊断门槛未通过:只输出初步观察和补证计划。
  • 无法访问外部资料且用户未提供竞品:进入本地证据模式,输出补证清单。
  • 没有用户需求证据:不得宣称市场空位。
  • 没有可证明优势:输出能力建设建议,不制造差异化标签。
  • 涉及第一、唯一、领先或效果承诺:要求独立证据和合规审查。

Output Contract

默认交付:

  • positioning-report.html:离线可视化决策报告。
  • positioning-report-data.json:唯一结构化事实源。
  • positioning-report.md:无脚本降级版与审计记录。

先用一页心智快照说清结论,再提供需求、竞争、优势、方案、行动、风险、证据和验证计划。个人 IP 或课程增加四层一致性,课程再增加行动路径、4P 与课程机制。缺失数据展示“证据不足”,不得伪造图表或总分。

交付前 review-report.py 必须通过。来源时效和证据警告可保留,但必须在报告和审校结果中可见;零警告交付使用 --strict。

Reference Map

  • 理论:references/theory-system.md、references/plain-language-positioning-method.md、references/course-marketing-method.md
  • 执行:references/intake-and-readiness-gate.md、references/ai-workflow.md
  • 研究:references/source-credibility-policy.md、references/competitor-research-method.md
  • 分析:references/demand-and-differentiation-method.md
  • 交付:references/report-contract.md、references/report-review-method.md、references/html-report-spec.md、references/metric-dictionary.md
  • 渲染资产:assets/report-template.html、assets/echarts.min.js
  • 系统说明:reports/positioning-skill-system-overview-2026-07-16/index.html
  • 分发净化:scripts/sanitize-package.py(仅在重建 ZIP 后执行)

© yaojingang, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 41 other files (scripts, references, assets) in skills/yao-positioning-skill of yaojingang/yao-open-skills.

  • SKILL.md
  • LICENSE
  • README.md
  • agents/interface.yaml
  • assets/LICENSE-echarts.txt
  • assets/NOTICE-echarts.txt
  • assets/echarts.min.js
  • assets/report-template.html
  • manifest.json
  • references/ai-workflow.md
  • references/competitor-research-method.md
  • references/course-marketing-method.md
  • references/demand-and-differentiation-method.md
  • references/html-report-spec.md
  • references/intake-and-readiness-gate.md
  • references/metric-dictionary.md
  • references/plain-language-positioning-method.md
  • references/report-contract.md
  • … and 24 more

Open the folder on GitHubat commit 093996e

Compare with similar skills

Yao Positioning Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Yao Positioning Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yao Positioning Skill this skillyaojingang/yao-open-skills1.3k—~805Automated safety check: PassMIT
Startup Designferdinandobons/startup-skill1.2k—~8.1kAutomated safety check: PassMIT
Competitive Intelligence Analystnicepkg/auto-company1941 repos~3.1kAutomated safety check: PassNone
Marketing Campaignaffaan-m/ECC276k1 repos~1.3kAutomated safety check: PassMIT
Icp Researchgrowthack88/growth-marketing-os116—~4.4kAutomated safety check: PassMIT
Copynicepkg/ai-workflow285—~3.1kAutomated safety check: PassMIT

Similar skills

  • Startup Design

    ferdinandobons/startup-skill

    Design, validate, and plan a startup from scratch. An agent skill from ferdinandobons/startup-skill.

    1.2k GitHub stars~8.1k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • A skill your agent uses when users need to analyze competitors, monitor market movements, benchmark features/pricing, identify market gaps, or understand competitive positioning.

    194 GitHub starsUsed in 1 repo~3.1k tokens
    Marketing & SEOAuto-check passed
  • Marketing Campaign

    affaan-m/ECC

    End-to-end marketing campaign planning and execution. An agent skill from affaan-m/ECC.

    276k GitHub starsUsed in 1 repo~1.3k tokens
    Marketing & SEOAuto-check passed
  • Icp Research

    growthack88/growth-marketing-os

    Scrapes case studies, testimonials, and solutions pages from a target website to build structured ICP documentation.

    116 GitHub stars~4.4k tokensUpdated 7 days ago
    Marketing & SEOAuto-check passed
  • Copy

    nicepkg/ai-workflow

    Professional copywriter for SaaS and startups. An agent skill from nicepkg/ai-workflow.

    285 GitHub stars~3.1k tokensUpdated 8 mo ago
    Marketing & SEOAuto-check passed
  • Competitor Analysis

    social-media-skills/skills

    Competitor analysis for social media — public-data competitive reconnaissance to find the gap a brand can own.

    128 GitHub stars~1.3k tokensUpdated 8 days ago
    Marketing & SEOAuto-check passed

More from yaojingang/yao-open-skills

All 16 skills in this repo
  • Yao Copyright Skill

    yaojingang/yao-open-skills

    A skill your agent uses when adding or auditing Yao copyright comment headers for an agent skill package, especially SKILL.md, README.md, references, prompts, templates, examples, scripts, YAML, or…

    1.3k GitHub stars~551 tokensUpdated 1 mo ago
    Auto-check passed
  • Yao Crux Skill

    yaojingang/yao-open-skills

    A skill your agent uses when a user is stuck in a complex real-world situation with many conflicts, limited resources, unclear priorities, or asks to identify the principal contradiction, secondary…

    1.3k GitHub stars~2.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Yao Interpreter Skill

    yaojingang/yao-open-skills

    Analyze local Agent Skill folders, SKILL.md files, or safe zip archives as untrusted input; explain purpose, trigger contract, structure, usage readiness, safety risks, evidence-backed 100-point…

    1.3k GitHub stars~545 tokensUpdated 1 mo ago
    Auto-check passed
  • Yao Bayesian Skill

    yaojingang/yao-open-skills

    Convert uncertain real-world choices into an auditable Bayesian evidence-to-action report with priors, evidence grading, posterior update, action thresholds, sensitivity checks, multi-turn decision…

    1.3k GitHub stars~956 tokensUpdated 1 mo ago
    Auto-check passed
  • Yao Business Skill

    yaojingang/yao-open-skills

    Design, diagnose, and study business models from ideas, product websites, or company names.

    1.3k GitHub stars~821 tokensUpdated 1 mo ago
    Auto-check passed
  • Yao Demand Skill

    yaojingang/yao-open-skills

    Evaluate product demand from product links, product descriptions, PRDs, websites, app-store pages, white papers, sales decks, screenshots, or funding materials using the demand triangle model: lack…

    1.3k GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Yao Positioning Skill

What does Yao Positioning Skill do?

Generate evidence-aware positioning reports for personal IPs, courses, products, services, brands, or companies by combining positioning theory, course-marketing analysis, user intent, competitor…. Yao Positioning Skill is an agent skill from yaojingang/yao-open-skills. Generate evidence-aware positioning reports for personal IPs, courses, products, services, brands, or companies by combining positioning theory, course-marketing analysis, user intent, competitor research, market demand, and verifiable advantages.

When should I use Yao Positioning Skill?

Yao Positioning Skill fits situations like: users ask for 定位、差异化分析、优势分析、心智定位、品类定位、竞品定位研究、定位报告或再定位建议; slogan-only copywriting; generic marketing ideas; standalone market research without a positioning recommendation.

How do I install Yao Positioning Skill in Claude Code?

Run `npx skills add yaojingang/yao-open-skills --skill yao-positioning-skill -a claude-code`. Or copy the skill folder (skills/yao-positioning-skill in yaojingang/yao-open-skills) into .claude/skills/yao-positioning-skill in your project. Claude Code loads it when a task matches its description.

How do I install Yao Positioning Skill in Codex?

Run `npx skills add yaojingang/yao-open-skills --skill yao-positioning-skill -a codex`. Or copy the skill folder (skills/yao-positioning-skill in yaojingang/yao-open-skills) into .agents/skills/yao-positioning-skill in your project. Codex loads it when a task matches its description.

Can I use Yao Positioning Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yaojingang/yao-open-skills --skill yao-positioning-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/yao-positioning-skill, .gemini/skills/yao-positioning-skill, .github/skills/yao-positioning-skill and .opencode/skills/yao-positioning-skill in your project.

What does Yao Positioning Skill need to run?

Going by SKILL.md and its folder, Yao Positioning Skill needs JavaScript for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3; Node.js.

Does Yao Positioning Skill access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Yao Positioning Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Yao Positioning Skill use?

Yao Positioning Skill is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Yao Positioning Skill use?

About 805 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 18k tokens, read only when the agent opens those files.

What are the alternatives to Yao Positioning Skill?

Skills that share tags, products or a category with Yao Positioning Skill: Startup Design (ferdinandobons/startup-skill, 1.2k stars), Competitive Intelligence Analyst (nicepkg/auto-company, 194 stars), Marketing Campaign (affaan-m/ECC, 276k stars) and Icp Research (growthack88/growth-marketing-os, 116 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yao Positioning Skill?

yaojingang (a GitHub user) maintains it in yaojingang/yao-open-skills, which has 1,322 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on August 28, 2026.

Source: yaojingang/yao-open-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.