docs: route integration evaluation to official guides

[yyiilluu]

Summary

• Keep the portable integration skill concise while making retrieved-learning attribution an explicit part of the runtime loop.
• Route evaluation setup and metric interpretation to the authoritative Reflexio documentation instead of duplicating detailed procedures in the skill.
• Preserve retrieval-experiment assignment across search and publish so integrated agents can support trustworthy impact measurement.

Changes

Skill guidance

• Add compact routing for retrieved-learning, head-to-head, and randomized retrieval evaluation questions.
• Teach coding agents to start with llms.txt, read the relevant task guide, and use the API reference for exact schemas.
• Distinguish retrieved-learning attribution from causal lift.

Runtime references

• Show Python and HTTP integrations retaining experiment_id and arm returned by search.
• Require both values to be echoed on publish, including holdout responses with no retrieved learnings.

Test Plan

• uv run python /Users/yilu/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/integrate-reflexio
• git diff --check
• Verified referenced evaluation, impact, and llms.txt documentation routes.

Summary by CodeRabbit

• Documentation
  • Added guidance for configuring and confirming evaluation workflows.
  • Documented randomized retrieval experiments, including preserving experiment assignments through search and publishing.
  • Clarified support for holdout responses and cases without an assignment.
  • Updated documentation navigation to prioritize the agents index, task guides, and API reference.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 75267b06-6a83-4e5d-aa1e-ab0de73d206b

📥 Commits

Reviewing files that changed from the base of the PR and between 46623f9 and 663e24d.

📒 Files selected for processing (3)

• skills/integrate-reflexio/SKILL.md
• skills/integrate-reflexio/references/http-api.md
• skills/integrate-reflexio/references/python-client.md

Included review availability: 3 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 4 reviews per hour.

---

📝 Walkthrough

Walkthrough

The integration guidance now covers evaluation routing and randomized retrieval experiments. It documents preserving search assignments, publishing paired experiment fields, handling holdout responses, and using updated documentation sources.

Changes

Evaluation guidance

Layer / File(s)	Summary
Evaluation workflow skills/integrate-reflexio/SKILL.md	The workflow adds evaluation routing, confirmation of the evaluation design, structured documentation lookup, focused validation, and assignment verification.
Experiment assignment propagation skills/integrate-reflexio/SKILL.md, skills/integrate-reflexio/references/http-api.md, skills/integrate-reflexio/references/python-client.md	The guides require retaining experiment_id and arm, publishing both fields together, supporting holdout responses without learnings, and omitting both fields when no assignment exists.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Merge Risk: ⚪ Minimal · up to 663e2

This documentation-focused change is merge-ready after normal checks and review; no actionable merge-blocking risk remains.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the documentation changes that route integration evaluation guidance to official Reflexio guides. It does not mention experiment-assignment propagation, but it clearly i…
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Full details: Title check

Explanation

The title accurately describes the documentation changes that route integration evaluation guidance to official Reflexio guides. It does not mention experiment-assignment propagation, but it clearly identifies a significant part of the changeset.

Full details: Docstring Coverage

Explanation

No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0 files. (3 skipped: 3 unsupported.)

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/docs-reflexio-integration-evaluation

Warning

Your free Security trial is over. An organization admin can activate billing to continue.

---

_{Comment @coderabbitai help to get the list of available commands.}