Agent skill

Yao Demand Skill

by yaojingang in 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…

MITAuto-check passedProduct & Project Management

Install Yao Demand Skill

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

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

GitHub CLI
$ gh skill install yaojingang/yao-open-skills yao-demand-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-demand-skill .claude/skills/yao-demand-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-demand-skill
GitHub stars
1.3k
Token cost
~1.4k tokens
SKILL.md length
597 words
Files
47 (incl. scripts, references)
Skills in repo
16
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 11 steps: Confirm the product input. Accept a URL,… → Build the product canvas: product… → Plan evidence. Prioritize official… → …
  • Asked for demand assessment
  • SKILL.md covers Use This Skill For, Do Not Route Here, Workflow and Output Contract, plus 1 more section
  • Runs Python scripts from its folder

What it does

Yao Demand Skill is an agent skill from 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, target object, and consumer ability. Use when asked for demand assessment, pre-investment product review, growth diagnosis, positioning validation, competitor-backed demand evidence, or a multi-format demand report. Do not use for pure market sizing, generic business-model design, UX-only review, legal/financial…

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 51 other files, including scripts and reference files (for example `README.md`, `agents/interface.yaml` and `evals/README.md`).

It sits in Product & Project Management, covering Copywriting, Product strategy and Market sizing. 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

  • Asked for demand assessment
  • Pre-investment product review
  • Growth diagnosis
  • Positioning validation

Example prompts

  • “/yao-demand-skill”

Requirements

  • Python 3

Workflow steps

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

  1. Confirm the product input. Accept a URL, text description, PRD, website copy, docs, screenshot, app-store page, sales material, or funding…
  2. Build the product canvas: product definition, user, scenario, features, price, promise, business model, market, source list, and…
  3. Plan evidence. Prioritize official sources, third-party validation, user feedback, competitor/substitute evidence, and time-sensitive…
  4. Research only evidence that can support or challenge demand. Current product, price, competitor, market, legal, or regulatory facts must…
  5. Segment users by JTBD, trigger scenario, buying role, current alternatives, and adoption blockers.
  6. Analyze the three demand triangle dimensions: lack, target_object, and consumer_ability. Include evidence, counter-evidence, assumptions…
  7. Score each dimension from 0 to 10, then calculate total score with the geometric short-board formula and confidence adjustment.
  8. Produce visual diagnostics: at least 10 chart modules, each with one or two insight sentences, one recommendation, confidence, and…
  9. Produce recommendations, forecast scenarios, and a final 30/60/90 day action plan: positioning, product, pricing, onboarding, trust…
  10. Run QA: citation coverage, time consistency, evidence diversity, at least three counter-signals, score explainability, chart completeness…
  11. Write a structured report JSON, then use scripts/render_report.py to create Markdown, HTML, Word, and PDF outputs.

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/ (Python, from the files we listed), which the agent can run.

    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 Demand Skill loads about 1.4k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 146 tokens; SKILL.md has 597 words of instructions outside code blocks.

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

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). 597 words, ~1,353 tokens.

Download SKILL.mdSave it as .claude/skills/yao-demand-skill/SKILL.md (or your agent's skills folder). This skill also uses 46 other files; get the full folder from GitHub.
name
yao-demand-skill
description
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, target object, and consumer ability. Use when asked for demand assessment, pre-investment product review, growth diagnosis, positioning validation, competitor-backed demand evidence, or a multi-format demand report. Do not use for pure market sizing, generic business-model design, UX-only review, legal/financial advice, or ad-copy ideation without demand evidence.
metadata.author
Yao Team
metadata.mode
production
metadata.model
Demand Triangle: lack + target object + consumer ability
metadata.output
Markdown, HTML, Word, PDF

Yao Demand Skill

Evidence-backed demand assessment for products, services, apps, SaaS, AI tools, consumer goods, education products, and early-stage ventures.

Use This Skill For

  • assessing whether a product has a solid demand foundation before building, investing, launching, or scaling
  • diagnosing weak conversion, weak retention, vague positioning, pricing friction, trust friction, or adoption barriers
  • comparing direct competitors, indirect substitutes, current user workarounds, and the option of not buying
  • producing a visual demand diagnosis report with citations, scores, red flags, 10+ chart modules, experiments, forecasts, and four final formats

Do Not Route Here

  • pure TAM/SAM/SOM market sizing without product-demand diagnosis
  • generic monetization or business-model option design; use a business-model skill instead
  • UX heuristic review without demand, JTBD, or adoption evidence
  • legal, financial, medical, or investment advice as a final decision
  • manipulative marketing designed to shame, scare, addict, or exploit vulnerable users

Workflow

  1. Confirm the product input. Accept a URL, text description, PRD, website copy, docs, screenshot, app-store page, sales material, or funding deck. Ask only one concise question if no product substance is available.
  2. Build the product canvas: product definition, user, scenario, features, price, promise, business model, market, source list, and unresolved assumptions.
  3. Plan evidence. Prioritize official sources, third-party validation, user feedback, competitor/substitute evidence, and time-sensitive market or regulatory facts.
  4. Research only evidence that can support or challenge demand. Current product, price, competitor, market, legal, or regulatory facts must be verified with sources and dates.
  5. Segment users by JTBD, trigger scenario, buying role, current alternatives, and adoption blockers.
  6. Analyze the three demand triangle dimensions: lack, target_object, and consumer_ability. Include evidence, counter-evidence, assumptions, and improvement paths.
  7. Score each dimension from 0 to 10, then calculate total score with the geometric short-board formula and confidence adjustment.
  8. Produce visual diagnostics: at least 10 chart modules, each with one or two insight sentences, one recommendation, confidence, and evidence or assumption binding.
  9. Produce recommendations, forecast scenarios, and a final 30/60/90 day action plan: positioning, product, pricing, onboarding, trust, channel, and validation experiments.
  10. Run QA: citation coverage, time consistency, evidence diversity, at least three counter-signals, score explainability, chart completeness, ethics, and layout readiness.
  11. Write a structured report JSON, then use scripts/render_report.py to create Markdown, HTML, Word, and PDF outputs.
Show full SKILL.md (225 more words)Show less

Output Contract

  • Always produce the final report in four formats: .md, .html, .docx, and .pdf.
  • Use one canonical report.json as the rendering source when possible, so the four outputs remain consistent.
  • HTML must include a top follow menu bar that stays pinned while the page scrolls, with quiet anchor navigation.
  • Formal reports must follow a summary -> visual diagnostics -> deep analysis -> final plan structure.
  • Formal reports must include at least 10 chart modules. HTML/PDF render them as inline SVG. Markdown and Word must include chart-equivalent tables or images.
  • All report backgrounds are pure white. Borrow Kami's editorial hierarchy, ink-blue accent, table discipline, typography, spacing, and production checks, but override Kami's parchment background.
  • Every key factual claim must either cite a source ID or be labeled as an assumption.
  • Every score must include evidence, reasoning, uncertainty, and a concrete improvement path.
  • Forecasts must be scenario-based and labeled with assumptions and confidence. Do not present uncertain adoption outcomes as deterministic predictions.

Reference Map

  • Read references/workflow.md before starting an assessment.
  • Read references/evidence-policy.md before using sources, citations, or current facts.
  • Read references/triangle-model.md before scoring.
  • Read references/report-contract.md before writing the report JSON or final narrative.
  • Read references/kami-white-report-layout.md before rendering the four output formats.
  • Use templates/report.schema.json as the report JSON target.
  • Use scripts/score_triangle.py to calculate or verify weighted scores.
  • Use scripts/validate_report.py before rendering.
  • Use scripts/render_report.py to generate Markdown, HTML, Word, and PDF.

© 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 46 other files (scripts, references) in skills/yao-demand-skill of yaojingang/yao-open-skills.

  • SKILL.md
  • README.md
  • agents/interface.yaml
  • evals/README.md
  • evals/resource_boundary_check.py
  • evals/trigger_cases.json
  • evals/trigger_eval.py
  • manifest.json
  • references/evidence-policy.md
  • references/kami-white-report-layout.md
  • references/report-contract.md
  • references/triangle-model.md
  • references/workflow.md
  • reports/artifact-design-profile.md
  • reports/humanoid-home-robot-demand-diagnosis/humanoid-home-robot-demand-diagnosis.docx
  • reports/humanoid-home-robot-demand-diagnosis/humanoid-home-robot-demand-diagnosis.html
  • … and 31 more

Open the folder on GitHubat commit 093996e

Compare with similar skills

Yao Demand 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 Demand Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yao Demand Skill this skillyaojingang/yao-open-skills1.3k—~1.4kAutomated safety check: PassMIT
Trellis Brainstormanjiemo/SunnyBeach1787 repos~4kAutomated safety check: PassApache-2.0
PlaidBuildGreatProducts/plaid218—~1.6kAutomated safety check: PassMIT
Customise Workflowanombyte93/prd-taskmaster605—~2kAutomated safety check: NotesMIT
Team OKR Brainstormphuryn/pm-skills27k—~1.1kAutomated safety check: PassMIT
YC Office Hoursgarrytan/gstack136k—~4.2kAutomated safety check: PassMIT

Similar skills

  • Trellis Brainstorm

    anjiemo/SunnyBeach

    Guides collaborative requirements discovery before implementation.

    178 GitHub starsUsed in 7 repos~4k tokens
    Product & Project ManagementAuto-check passed
  • Plaid

    BuildGreatProducts/plaid

    Product Led AI Development — guides founders from idea to launched product.

    218 GitHub stars~1.6k tokensUpdated 5 mo ago
    Product & Project ManagementAuto-check passed
  • Customise Workflow

    anombyte93/prd-taskmaster

    Customise the prd-taskmaster plugin workflow via curated brainstorm questions.

    605 GitHub stars~2k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check: notes
  • Team OKR Brainstorm

    phuryn/pm-skills

    Drafts three alternative sets of team OKRs, each with an inspiring objective and measurable key results, tied to the company strategy you provide.

    27k GitHub stars~1.1k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • YC Office Hours

    garrytan/gstack

    Runs a YC-style office hours session that pressure-tests a product idea before any code and ends in a design document instead of an implementation.

    136k GitHub stars~4.2k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Product Planner

    BuildGreatProducts/builder-os

    Vision intake conversation followed by generation of three product documents — docs/product-vision.md (strategy and brand), docs/prd.md (technical spec for coding agents), and…

    228 GitHub stars~4.6k tokensUpdated 3 mo ago
    Product & Project ManagementAuto-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 Positioning Skill

    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…

    1.3k GitHub stars~805 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

Questions about Yao Demand Skill

What does Yao Demand Skill do?

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…. Yao Demand Skill is an agent skill from 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, target object, and consumer ability.

When should I use Yao Demand Skill?

Yao Demand Skill fits situations like: asked for demand assessment; pre-investment product review; growth diagnosis; positioning validation.

How do I install Yao Demand Skill in Claude Code?

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

How do I install Yao Demand Skill in Codex?

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

Can I use Yao Demand 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-demand-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-demand-skill, .gemini/skills/yao-demand-skill, .github/skills/yao-demand-skill and .opencode/skills/yao-demand-skill in your project.

What does Yao Demand Skill need to run?

Going by SKILL.md and its folder, Yao Demand Skill needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Yao Demand 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 Demand 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 Demand Skill use?

Yao Demand Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Yao Demand Skill use?

About 1.4k tokens (SKILL.md is roughly 5.4k 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 9.8k tokens, read only when the agent opens those files.

What are the alternatives to Yao Demand Skill?

Skills that share tags, products or a category with Yao Demand Skill: Trellis Brainstorm (anjiemo/SunnyBeach, 178 stars), Plaid (BuildGreatProducts/plaid, 218 stars), Customise Workflow (anombyte93/prd-taskmaster, 605 stars) and Team OKR Brainstorm (phuryn/pm-skills, 27k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yao Demand Skill?

yaojingang (a GitHub user) maintains it in yaojingang/yao-open-skills, which has 1,323 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.