Agent skill

Yao Kelly Skill

by yaojingang in yaojingang/yao-open-skills

Turn uncertain resource-allocation requests into practical action plans using Kelly sizing as a conservative allocation engine.

MITAuto-check passedEducation

Install Yao Kelly Skill

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

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

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

At a glance

Turn uncertain resource-allocation requests into practical action plans using Kelly sizing as a conservative allocation engine.

  • Works in 9 steps: Use references/intake-contract.md to… → If the input is incomplete, read… → Decide whether Kelly is suitable → …
  • A user needs to decide whether an opportunity is suitable for Kelly
  • SKILL.md covers Use This Skill For, Do Not Route Here, Default Workflow and Core Rules, plus 1 more section
  • What minimum action package to run

What it does

Yao Kelly Skill is an agent skill from yaojingang/yao-open-skills. Turn uncertain resource-allocation requests into practical action plans using Kelly sizing as a conservative allocation engine. Use when a user needs to decide whether an opportunity is suitable for Kelly, what minimum action package to run, how much resource to cap, when to add or stop, and how to review results. Do not use for pure formula tutoring, guaranteed-return claims, martingale escalation, or final licensed investment, legal, or tax advice.

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

It sits in Education, covering Tutoring and explanations. 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

  • A user needs to decide whether an opportunity is suitable for Kelly
  • What minimum action package to run
  • How much resource to cap
  • How to review results

Example prompts

  • “/yao-kelly-skill”

Workflow steps

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

  1. Use references/intake-contract.md to identify the user's real resource pool, decision question, minimum action unit, review window, and…
  2. If the input is incomplete, read references/multi-turn-kelly-loop.md
  3. Decide whether Kelly is suitable
  4. Use references/kelly-sizing-playbook.md to choose the formula path
  5. Run scripts/kelly_allocation_report.py for canonical JSON sizing output.
  6. Run scripts/generate_html_report.py when the user wants a polished standalone HTML report or PDF-ready artifact.
  7. Use references/output-contract.md to produce a practical allocation report
  8. Use references/logging-contract.md to maintain
  9. Apply references/safety-and-scope.md before finalizing.

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/, 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 Kelly Skill loads about 1.2k tokens when it runs, and up to ~5.7k if it reads all its reference files. Until then it costs about 118 tokens; SKILL.md has 556 words of instructions outside code blocks.

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

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). 556 words, ~1,153 tokens.

Download SKILL.mdSave it as .claude/skills/yao-kelly-skill/SKILL.md (or your agent's skills folder). This skill also uses 28 other files; get the full folder from GitHub.
name
yao-kelly-skill
description
Turn uncertain resource-allocation requests into practical action plans using Kelly sizing as a conservative allocation engine. Use when a user needs to decide whether an opportunity is suitable for Kelly, what minimum action package to run, how much resource to cap, when to add or stop, and how to review results. Do not use for pure formula tutoring, guaranteed-return claims, martingale escalation, or final licensed investment, legal, or tax advice.

Yao Kelly Skill

Use This Skill For

  • turn "should I invest, bet, or allocate, and how much?" into a practical resource allocation plan
  • decide whether the user's problem is actually suitable for Kelly-style sizing
  • translate a percentage into a minimum action package with owner, metric, review window, add condition, and stop condition
  • start with incomplete input, give a provisional view early, then ask only the minimum high-impact follow-up questions
  • size a single bet or opportunity, or conservatively split a pool across several opportunities
  • keep a round-by-round log for the current case and an append-only change log for future edits to this skill

Do Not Route Here

  • pure formula tutoring, homework solving, or generic finance education
  • requests for guaranteed returns, sure-win systems, or martingale-style escalation
  • final licensed investment, legal, or tax advice
  • leverage sizing with no bounded downside model

Default Workflow

  1. Use references/intake-contract.md to identify the user's real resource pool, decision question, minimum action unit, review window, and opportunity candidates.
  2. If the input is incomplete, read references/multi-turn-kelly-loop.md:
    • ask only 1-3 questions that can materially change the result
    • recalculate decision_readiness after every round
    • stop asking when the threshold is met or the action class is already stable
  3. Decide whether Kelly is suitable:
    • use it when downside is bounded, the opportunity can be tested or repeated, and probabilities can be approximated
    • switch to a test-first or risk-review answer when the decision is irreversible, one-off, or has unbounded downside
  4. Use references/kelly-sizing-playbook.md to choose the formula path:
    • binary opportunity: standard Kelly closed form
    • scenario-based opportunity: maximize E[log(1 + f * r)]
    • multiple opportunities: compute standalone Kelly first, then apply fractional Kelly, dependence haircuts, and total exposure scaling
  5. Run scripts/kelly_allocation_report.py for canonical JSON sizing output.
  6. Run scripts/generate_html_report.py when the user wants a polished standalone HTML report or PDF-ready artifact.
  7. Use references/output-contract.md to produce a practical allocation report:
    • resource snapshot
    • fit assessment
    • minimum action packages
    • Kelly sizing cap
    • add, stop, and review conditions
  8. Use references/logging-contract.md to maintain:
    • the case round log for the current user request
    • the append-only iteration log in history/CHANGELOG.md whenever this skill package changes
  9. Apply references/safety-and-scope.md before finalizing.
Show full SKILL.md (205 more words)Show less

Core Rules

  • default to fractional Kelly, not full Kelly
  • never make the formula the main product; the main product is a resource allocation action plan
  • mark each key number as observed, estimated, or assumed
  • if correlation across opportunities is unknown, shrink exposure instead of assuming independence
  • if the edge is negative, fragile, or mostly assumption-driven, recommend no allocation, observe, or run a cheap test first
  • always translate the final fraction into the smallest next action the user can actually do
  • include add, stop, and review conditions so the allocation can improve after real feedback
  • stop asking once more questions are unlikely to change the action class
  • every future edit to this skill must append a dated note to history/CHANGELOG.md

Output Contract

  • deliver a Kelly application report, not just a formula
  • prefer HTML + JSON when the user wants a report artifact; use JSON as the audit source and HTML as the readable hand-back
  • the report must include:
    • recommendation summary and action class
    • Kelly fit assessment
    • current capital or resource base, protected reserve, risk budget, and translated amount
    • minimum action package per opportunity
    • full Kelly fraction and conservative Kelly execution cap
    • add, stop, and review conditions
    • formula path and key assumptions
    • why the questioning stopped
    • round log

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

  • SKILL.md
  • README.md
  • agents/interface.yaml
  • history/CHANGELOG.md
  • logs/README.md
  • manifest.json
  • references/intake-contract.md
  • references/kelly-sizing-playbook.md
  • references/logging-contract.md
  • references/multi-turn-kelly-loop.md
  • references/output-contract.md
  • references/safety-and-scope.md
  • reports/design-summary.md
  • reports/engineering-hours-brief.json
  • reports/engineering-hours-output.json
  • reports/engineering-hours-report.html
  • … and 13 more

Open the folder on GitHubat commit 093996e

Compare with similar skills

Yao Kelly 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 Kelly Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yao Kelly Skill this skillyaojingang/yao-open-skills1.3k—~1.2kAutomated safety check: PassMIT
DeepTutor CLIHKUDS/DeepTutor41k—~2.8kAutomated safety check: PassApache-2.0
AI Engineering Project Tutorrohitg00/ai-engineering-from-scratch67k—~1.6kAutomated safety check: PassMIT
Hung-Yi Lee Teaching Stylevoidful/hung-yi-lee-skill1.3k—~13kAutomated safety check: PassNone
Claude Certification Tutorrohitg00/ai-engineering-from-scratch67k—~3kAutomated safety check: PassMIT
StudyVault Quiz Tutorbevibing/tutor-skills1.3k—~1.4kAutomated safety check: PassMIT

Similar skills

  • DeepTutor CLI

    HKUDS/DeepTutor

    Teaches the agent to set up and run DeepTutor from the command line: chat and capabilities, knowledge bases, partners, memory, sessions, notebooks and the server or Web app.

    41k GitHub stars~2.8k tokensUpdated 3 days ago
    EducationAuto-check passed
  • AI Engineering Project Tutor

    rohitg00/ai-engineering-from-scratch

    Tutors a learner through one stage of a hands-on AI engineering project per session: lesson, prediction, code, grader run and reflection, with hints but never full solutions.

    67k GitHub stars~1.6k tokensUpdated today
    EducationAuto-check passed
  • Hung-Yi Lee Teaching Style

    voidful/hung-yi-lee-skill

    Explains machine learning, LLMs, AI agents and speech modeling in a Hung-Yi Lee-inspired teaching style, drawing on a knowledge base built from his lectures and research references.

    1.3k GitHub stars~13k tokensUpdated 2 mo ago
    EducationAuto-check passed
  • Claude Certification Tutor

    rohitg00/ai-engineering-from-scratch

    Guides a learner through one of four independent Claude certification tracks with onboarding, lessons, practice labs, mock exams and remediation.

    67k GitHub stars~3k tokensUpdated today
    EducationAuto-check passed
  • StudyVault Quiz Tutor

    bevibing/tutor-skills

    Quizzes you on the notes in an Obsidian StudyVault, tracks proficiency per concept and drills weak areas in four-question rounds.

    1.3k GitHub stars~1.4k tokensUpdated 7 mo ago
    EducationAuto-check passed
  • Designs a review-and-practice lesson around an independent first attempt, targeted feedback, supported practice, a fresh independent check and a next step.

    40k GitHub stars~1.1k tokensUpdated today
    EducationAuto-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

Categories

Questions about Yao Kelly Skill

What does Yao Kelly Skill do?

Turn uncertain resource-allocation requests into practical action plans using Kelly sizing as a conservative allocation engine. Yao Kelly Skill is an agent skill from yaojingang/yao-open-skills. Turn uncertain resource-allocation requests into practical action plans using Kelly sizing as a conservative allocation engine.

When should I use Yao Kelly Skill?

Yao Kelly Skill fits situations like: A user needs to decide whether an opportunity is suitable for Kelly; what minimum action package to run; how much resource to cap; how to review results.

How do I install Yao Kelly Skill in Claude Code?

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

How do I install Yao Kelly Skill in Codex?

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

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

What does Yao Kelly Skill need to run?

SKILL.md names no scripts, command-line tools or credentials: Yao Kelly Skill is instructions for the agent only.

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

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

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

What are the alternatives to Yao Kelly Skill?

Skills that share tags, products or a category with Yao Kelly Skill: DeepTutor CLI (HKUDS/DeepTutor, 41k stars), AI Engineering Project Tutor (rohitg00/ai-engineering-from-scratch, 67k stars), Hung-Yi Lee Teaching Style (voidful/hung-yi-lee-skill, 1.3k stars) and Claude Certification Tutor (rohitg00/ai-engineering-from-scratch, 67k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yao Kelly 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.