Marketing Tools / Measurement

Agent Share of Choice Evaluator

Evaluate brand progression across retrieval, consideration, recommendation, selection, transaction, completion, and reuse in agent-mediated tasks.

DocumentationAgent instructionsRequirements & limits

Use when a team needs a repeatable task-panel evaluation of paid, earned, and executable brand participation.

Inputs

The released example shows these fields. Check the guide for which are required.

  • panel_version
  • tasks
  • surfaces
  • brand

Outputs

  • Stage evidence
  • Route comparison
  • Confidence and next-test report

Before you begin

  • Reading and copying the procedure require no terminal setup. Check requirements for any packaged programs separately.

Try this first

Read the procedure and supply its documented inputs. Use the full text in an agent app or chat that supports pasted instructions, following that host's guidance.

Limits for this step
  • Instruction package only; it does not provide or authorize an executable runtime capability.
  • Evaluation only; do not publish comparative claims without methodology and human review.
Read full instructionsHide full instructionsSKILL.md · v0.1.0

Agent Share of Choice Evaluator

When to use

Use this skill for the situations described in its frontmatter routing description.

Workflow

  1. Load a versioned task panel and freeze the evaluation conditions.
  2. Run each task consistently across the selected agent surfaces.
  3. Capture evidence for retrieval, understanding, consideration, recommendation, paid response, selection, transaction, completion, and reuse.
  4. Label observed, synthetic, platform-reported, and independently verified evidence separately.
  5. Calculate stage rates only where denominators and samples are explicit.
  6. Compare paid, earned, and executable routes without collapsing them into one rank.
  7. Report failures, uncertainty, and the next experiment.

Output

  • task panel version and run conditions
  • stage evidence by task
  • stage rates with sample sizes
  • route comparison
  • evidence quality and confidence
  • failure modes and next tests

Guardrails

  • Do not claim a universal agent ranking.
  • Do not treat one model, prompt, geography, or session as representative.
  • Do not merge paid exposure with earned recommendation.
  • Do not call platform conversion data independently verified.
View file metadata
---
name: agent-share-of-choice-evaluator
description: Evaluate whether a brand is retrieved, understood, considered, recommended, selected, transacted with, and used successfully across a stable panel of agent-mediated customer tasks. Use for AI visibility, conversational advertising, agentic commerce, or paid-versus-earned discovery experiments.
---

Summary sources · Catalogue metadata, skill.yaml, SKILL.md, examples/input.json, examples/output.json · v0.1.0 · Release package

Install instruction files

These commands copy guidance into the selected runtime directories. Confirm that your agent app discovers it. Any packaged programs need separate setup and verification.

Install (Codex)

./bin/skills-hub install marketing/[email protected] --runtime codex

Install (Claude)

./bin/skills-hub install marketing/[email protected] --runtime claude

Install (Generic)

./bin/skills-hub install marketing/[email protected] --runtime generic --target ./my-agent/skills

How You Can Use This

Documentation

Resource form: Agent instructions

Read or copy the guidance. Any packaged programs have separate execution requirements and evidence.

First run: Read SKILL.md and follow the documented workflow.

Current limits

  • Instruction package only; it does not provide or authorize an executable runtime capability.
What installation and verification mean
File installation
Places package files and generated configuration in the selected directories.
Native discovery
Your agent app finds and accepts the instructions, tools or plugin registrations.
Mock execution
Exercises sample fixtures. Connected data and provider effects need a separate check.
Connected operation
Requires current configuration, provider authentication, scoped permissions and a successful operation in your intended environment.

Declared compatibility

Compatibility unknown: versions and capabilities have not been declared.

Classification: declared

Technical details and release files

Operational Summary

Execution mode: analysis-only

Approval boundary: Evaluation only; do not publish comparative claims without methodology and human review.

Review and lifecycle

Review maturity: Experimental

Security review declaration: Not declared

Lifecycle: Active

These release declarations are separate from evidence that a workflow operates in your environment.

Runtime & Dependencies

ID: marketing/agent-share-of-choice-evaluator

Tags: agent-visibility, share-of-choice, chatgpt-ads, agentic-commerce, evaluation

Runtimes: codex, claude, generic

Tool dependencies: 0

API dependencies: 0

Dependencies

Tools: Not documented

APIs: Not documented

Outputs

  • Stage evidence
  • Route comparison
  • Confidence and next-test report