Skip to content

Sync agenteye-evaluator skill (agenteye@3ddd9de)#9

Open
NiveditJain wants to merge 1 commit into
mainfrom
sync/agenteye-evaluator
Open

Sync agenteye-evaluator skill (agenteye@3ddd9de)#9
NiveditJain wants to merge 1 commit into
mainfrom
sync/agenteye-evaluator

Conversation

@NiveditJain

@NiveditJain NiveditJain commented Jul 19, 2026

Copy link
Copy Markdown
Member

Automated mirror — do not hand-edit this folder.

Source of truth FailproofAI/agenteyeevaluator-sdk/skill/
Target skills/agenteye-evaluator/
Triggered from agenteye main @ 3ddd9de

The skills repo's validate-skills.py passed. To change the skill, edit evaluator-sdk/skill/ in agenteye and re-run the Sync agenteye-evaluator skill workflow — this same PR refreshes.

Summary by CodeRabbit

  • Documentation
    • Clarified evaluator workflows by distinguishing plan-only and build modes.
    • Added a comprehensive brainstorming guide for creating evaluation plans from session data.
    • Documented dataset exploration, candidate metric validation, and evaluation-plan artifact structure.
    • Improved SDK installation guidance by clarifying when to stop the installation process.

@NiveditJain NiveditJain added the skill-sync-agenteye-evaluator Automated agenteye-evaluator skill mirror PRs from FailproofAI/agenteye label Jul 19, 2026
@NiveditJain
NiveditJain requested a review from SiddarthAA July 19, 2026 07:28
@coderabbitai

coderabbitai Bot commented Jul 19, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The evaluator skill now documents separate plan and build modes, adds a detailed brainstorm reference for producing evaluation plans from logs, and clarifies SDK installation guidance.

Changes

Evaluator skill workflows

Layer / File(s) Summary
Plan and build mode contract
skills/agenteye-evaluator/SKILL.md
The skill distinguishes written evaluation planning from scoring-service construction, clarifies the build design loop, and adds a CI trigger comment.
Brainstorm evaluation-planning workflow
skills/agenteye-evaluator/references/brainstorm.md
A new reference documents CLI and SQL exploration, corpus selection, session comparison, candidate dimension filtering, convergence, and eval-plan output.
SDK installation ladder guidance
skills/agenteye-evaluator/references/scaffold.md
The installation guidance clarifies the public PyPI warning and stopping at the first applicable rung.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

  • FailproofAI/skills#4: Overlapping synchronization and updates to the agenteye-evaluator skill documentation.

Suggested reviewers: siddarthaa

Poem

I hopped through plans where evals may grow,
Or build their scoring code below.
I read the logs, both good and bad,
And shaped the measures agents had.
The ladder’s clear, the paths align—
A tidy burrow, by design!

🚥 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 an automated sync of the agenteye-evaluator skill and matches the main change.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

@NiveditJain
NiveditJain force-pushed the sync/agenteye-evaluator branch from 16b3f6b to 78407ff Compare July 19, 2026 10:58
Automated mirror of evaluator-sdk/skill/. Source of truth: FailproofAI/agenteye — do not hand-edit.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@skills/agenteye-evaluator/references/brainstorm.md`:
- Around line 130-138: Update the SQL example in the population-confirmation
section to explicitly compare good and bad session cohorts, using reviewed
session-ID lists or equivalent verdict-based cohort membership. Ensure the
output reports the metric by cohort so it can demonstrate separation, or clearly
relabel the query as feature extraction rather than discrimination evidence.
- Around line 163-171: Update the Filter A guidance and example around the
agenteye events query to measure payload-field coverage across the full
candidate population rather than a single session. Add a population-level query
that reports both sessions with the field populated and the total
eligible-session denominator, and require that coverage result before retaining
the dimension.
- Around line 90-94: Update the session inspection guidance around the `agenteye
--json events` command to explicitly page through results beyond the `--limit
1000` cap using the documented cursor mechanism. Require verifying that the
complete event stream has been retrieved before analyzing or cataloging a
session, while preserving the payload-free-first and selective `--full`
workflow.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: bc74dde9-6a53-437d-9cc9-81d9da3d47d5

📥 Commits

Reviewing files that changed from the base of the PR and between 0ae1292 and 89dc7a9.

📒 Files selected for processing (3)
  • skills/agenteye-evaluator/SKILL.md
  • skills/agenteye-evaluator/references/brainstorm.md
  • skills/agenteye-evaluator/references/scaffold.md

Comment on lines +90 to +94
Pull mechanics are in [`session-data.md`](session-data.md): the export endpoint gives
a byte-identical fixture, or `agenteye --json events --full --session-id <id> --order
asc --all --limit 1000`. Skim on the payload-free feed first (its one-line server
`summary` per event is ideal for reading a session's *shape*), then `--full` only on
the ones you're reading line by line. **Confirm the corpus with the user** before you

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Page selected sessions until the complete event stream is retrieved.

This workflow hard-caps session reads at --limit 1000, while the later CLI guidance says larger results require cursor paging. A session with more than 1,000 events can therefore be misclassified from incomplete evidence. Explicitly instruct the agent to continue paging and verify that the session is complete before cataloging it.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@skills/agenteye-evaluator/references/brainstorm.md` around lines 90 - 94,
Update the session inspection guidance around the `agenteye --json events`
command to explicitly page through results beyond the `--limit 1000` cap using
the documented cursor mechanism. Require verifying that the complete event
stream has been retrieved before analyzing or cataloging a session, while
preserving the payload-free-first and selective `--full` workflow.

Comment on lines +130 to +138
Then don't stop at the sample — **confirm it holds across the population.** The metric
that looked decisive in two sessions may wash out over two hundred. Where the metric
is expressible in SQL, compute it per session and compare the cohorts:

```bash
# does "how it ended" actually track the user's good/bad call?
agenteye --json query run --sql \
"SELECT session_id, countIf(event_type='agent_end') AS ended, count() AS events
FROM events GROUP BY session_id ORDER BY ended ASC, events DESC LIMIT 30"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Make the discrimination query compare good and bad cohorts.

The example query only reports agent_end and event counts per session; it never groups sessions by the user’s good/bad verdict. As written, it can show a distribution but cannot establish the required good-vs-bad separation. Add explicit cohort membership—such as reviewed session-ID lists—or label the query as a feature-extraction step rather than discrimination evidence.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@skills/agenteye-evaluator/references/brainstorm.md` around lines 130 - 138,
Update the SQL example in the population-confirmation section to explicitly
compare good and bad session cohorts, using reviewed session-ID lists or
equivalent verdict-based cohort membership. Ensure the output reports the metric
by cohort so it can demonstrate separation, or clearly relabel the query as
feature extraction rather than discrimination evidence.

Comment on lines +163 to +171
**Filter A — is the signal in the transcript, and actually populated?** Name the exact
event types and payload fields that feed the dimension. Then *prove the field is there
in their data* — the schema allowing a field doesn't mean their instrumentation emits
it:

```bash
agenteye --json events --full --session-id <id> --all --limit 1000 \
| jq '[.events[] | select(.event_type=="tool_use") | .payload.tool_name] | unique'
```

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Validate field coverage across the population, not one session.

The Filter A example checks payload presence for a single <id>, despite requiring that the signal be “actually populated.” A candidate can pass this check while the field is absent from most sessions. Add a population-level coverage query and report the populated-session denominator before retaining the dimension.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@skills/agenteye-evaluator/references/brainstorm.md` around lines 163 - 171,
Update the Filter A guidance and example around the agenteye events query to
measure payload-field coverage across the full candidate population rather than
a single session. Add a population-level query that reports both sessions with
the field populated and the total eligible-session denominator, and require that
coverage result before retaining the dimension.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skill-sync-agenteye-evaluator Automated agenteye-evaluator skill mirror PRs from FailproofAI/agenteye

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants