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
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
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/ya-direct-hypothesis-planningDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad 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 rublesLimitations
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.
Related
All Yandex Direct toolsYandex Direct no-history hypothesis skill
ya-direct-create-new-hypothesis
A Codex skill for product, offer and audience discovery when a Yandex Direct account has no usable delivery history yet
Yandex Direct statistics skill
ya-direct-statistics
A Codex skill for building and reading Yandex Direct reports: Report Wizard, the report library, filters, attribution and safe browser workflows
End-to-end Yandex Direct audit skill
ya-direct-codex
An Agent Skill for full Yandex Direct audit, optimization and API v5 work: search, the ad network, Unified Performance, strategies and attribution
Yandex Direct skill with CPA optimization
Yandex.Direct Skill для Claude Code
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
Yandex Direct Library section skill
ya-direct-library
An Agent Skill for the Yandex Direct Library: audience segments, feeds, package strategies, A/B experiments and landing pages
A skill for auditing and running Yandex Direct campaigns via API v5: 55 checks, an A-F grade, ad creation and reports
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.