Yandex Direct data-driven hypothesis planning skill

ya-direct-hypothesis-planning

A Codex skill turns already-served Yandex Direct campaign data into a prioritized backlog of testable hypotheses

  • 1 ★ on the repository
  • Last commit
  • MIT
Skill

Broad access

Why this level

  • Can propose, and after approval carry out, budget and campaign changes
  • Works with an advertising account's spend and conversion reports
All reasons and checks
Russian stack

rdsolod-ui/ya-direct-hypothesis-planning

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/ya-direct-hypothesis-planning

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Can propose, and after approval carry out, budget and campaign changes
  • Works with an advertising account's spend and conversion reports

This is third-party code. Review the repository files before installing.

What it does

The skill takes locally supplied reports and turns them into a hypothesis backlog: it first fixes the report contract together with the ya-direct-statistics skill, then normalizes rows, separating observed columns from calculated metrics, computes a weighted baseline and Wilson confidence intervals for CTR and conversion rate instead of averaging row-level ratios. It checks data sufficiency against user-set thresholds and returns INSUFFICIENT rather than a guessed conclusion when data is thin. It diagnoses where in the funnel a change occurs, builds one hypothesis per variable with an exact decision rule, and sizes a test budget only within an explicitly provided envelope. Exports, budget edits, campaign changes and launches stay behind explicit approval.

Who it is for. For people who already have trustworthy Yandex Direct delivery statistics and need it turned into a concrete test list, not vague conclusions.

Good fit when

  • Campaigns already have impressions, clicks, spend and conversions, and you need to decide what to test next
  • You need to tell a statistically real CTR difference from noise
  • You need to size a test's budget and duration against an explicitly given amount

Not a fit when

  • There is no delivery history yet: use the companion ya-direct-create-new-hypothesis skill
  • Data does not meet your thresholds: the skill returns INSUFFICIENT, not a hypothesis
  • You want the skill to launch the test or change budget itself: that stays behind separate approval

Example request

Here is a 60-day campaign report, build a hypothesis backlog with confidence intervals and propose a test budget within 20,000 rubles

Limitations

Works only with locally supplied data; downloading or exporting advertiser data needs explicit approval at each step. Does not guess with an incomplete report contract, mixed attribution or unknown denominators, and honestly returns INSUFFICIENT instead. Install targets Codex via the skills.sh registry.

How to disable. Remove the skills/ya-direct-hypothesis-planning directory from your agent's installed skills.

FAQ

What does the skill do when data is thin?

It returns INSUFFICIENT instead of a hypothesis if the data misses the set sufficiency thresholds or attribution and denominators are undefined.

Can the skill launch the recommended test itself?

No, any export, budget edit, campaign change or launch needs separate explicit approval at that specific step.

Discussion

No questions or reviews yet.

Yandex Direct no-history hypothesis skill

ya-direct-create-new-hypothesis

Russian stack

A Codex skill for product, offer and audience discovery when a Yandex Direct account has no usable delivery history yet

SkillMinimal access1Repository stars

Yandex Direct statistics skill

ya-direct-statistics

Russian stack

A Codex skill for building and reading Yandex Direct reports: Report Wizard, the report library, filters, attribution and safe browser workflows

SkillExtended access1Repository stars
Russian stack

An Agent Skill for full Yandex Direct audit, optimization and API v5 work: search, the ad network, Unified Performance, strategies and attribution

SkillBroad access1Repository stars

Yandex Direct skill with CPA optimization

Yandex.Direct Skill для Claude Code

Russian stack

A dependency-free Python skill that builds Direct campaigns from a blueprint, pulls leads from Metrika and optimizes bids toward a target CPA or ROI

SkillBroad access5Repository stars
Russian stack

An Agent Skill for the Yandex Direct Library: audience segments, feeds, package strategies, A/B experiments and landing pages

SkillBroad access1Repository stars
Russian stack

A skill for auditing and running Yandex Direct campaigns via API v5: 55 checks, an A-F grade, ad creation and reports

SkillBroad access64Repository stars

README in short

The README describes the skill as a tool for hypotheses backed by already-served data and explicit test budgets, gives the Codex install command, and a ten-step workflow in SKILL.md from the report contract to preparing a handoff for the creatives skill. It separately lists local validation commands: validate_skill.py, unittest and script compilation.

README badge

Original SKILL.md

---
name: ya-direct-hypothesis-planning
description: Analyze already-served Yandex Direct performance data and budgets to produce evidence-backed, prioritized, single-variable advertising hypotheses, test designs, budget proposals, and a creative handoff. Use when campaigns have historical impressions, clicks, spend, conversions, revenue, or element-level results. Fail closed on incomplete reporting contracts and keep exports, budget edits, campaign changes, and launches behind explicit approval.
---

# Yandex Direct Hypothesis Planning

Turn historical delivery data into a decision-ready test backlog. Do not treat
correlation, platform recommendations, or small samples as causal proof.

Report a problem