CEORater

Get institutional-grade CEO performance analytics for S&P 500 companies. Proprietary scores: CEORaterScore (composite), AlphaScore (market outperformance), R...

Security Scan

The skill's code, runtime instructions, and requested credential (CEORATER_API_KEY) are coherent with its stated purpose of calling the CEORater API and do not request unrelated access.

Purpose & Capability

The name/description advertise CEO analytics via the CEORater API and the skill only requires a single CEORATER_API_KEY to call api.ceorater.com endpoints. No unrelated services, binaries, or config paths are requested.

Instruction Scope

SKILL.md instructs the agent to call documented API endpoints (GET /v1/ceo, /v1/search, /v1/ceos, /v1/meta) and to use the CEORATER_API_KEY. The helper script calls only the api.ceorater.com domain, sanitizes input, URL-encodes queries, and enforces simple validation. There are no instructions to read unrelated files, system credentials, or send data to unexpected endpoints.

Install Mechanism

This is instruction-only (no installer). The repo contains a small helper shell script; there is no network-download install step or use of third-party package registries. Risk from installation is low.

Credentials

Only one environment variable (CEORATER_API_KEY) is required and it directly maps to the service being integrated. README notes an alternate config key in openclaw.json (apiKey) which is consistent with storing credentials locally; no other secrets or unrelated credentials are requested.

Persistence & Privilege

The skill is not always-enabled (always:false) and registry shows disable-model-invocation:true (model cannot autonomously invoke it), limiting autonomous access. The skill does not request changes to other skills or system-wide config beyond optional local API-key configuration.

Assessment

This skill appears to do only what it claims: call the CEORater API using your CEORATER_API_KEY. Before installing, confirm you trust https://www.ceorater.com and your subscription, and avoid placing the API key in world-readable files. Keep the key secret (use environment variables or secure per-agent config), monitor usage/rate limits, and review the CEORater terms for allowed data use (enterprise restrictions on model training are noted). The helper script sanitizes input and only contacts api.ceorater.com, but remember that any skill that calls external APIs transmits queries and receives data — if you have sensitive prompts or PII, avoid sending them to third-party services.

CEORater Skill

Query CEO performance data for S&P 500 and major U.S. public companies via the CEORater API.

Prerequisites

1. Get an API key at https://www.ceorater.com/api-docs.html ($99/month per user)
2. Set the environment variable: CEORATER_API_KEY=zpka_your_key_here

Licensing Note: Self-serve API access permits individual research and analysis. Integrating CEORater data into proprietary firm models, AI/ML training, or building products requires an Enterprise Agreement — contact [e-mail].

Available Metrics

Metric	Range	Description
CEORaterScore	0-100	Composite CEO effectiveness rating
AlphaScore	0-100	Performance vs. market benchmark
RevenueCAGRScore	0-100	Tenure-adjusted revenue growth percentile
CompScore	A-F	Compensation efficiency grade
TSR During Tenure	%	Total Stock Return during CEO tenure
TSR vs. S&P 500	%	Performance relative to S&P 500 (SPY)
CEO Compensation	$M	Total compensation from most recent proxy filing
Revenue CAGR	%	Tenure-adjusted compound annual revenue growth

API Endpoints

Get CEO by Ticker

curl -H "Authorization: Bearer $CEORATER_API_KEY" \
  "https://api.ceorater.com/v1/ceo/AAPL?format=raw"

Search CEOs

curl -H "Authorization: Bearer $CEORATER_API_KEY" \
  "https://api.ceorater.com/v1/search?q=technology&format=raw"

List All CEOs

curl -H "Authorization: Bearer $CEORATER_API_KEY" \
  "https://api.ceorater.com/v1/ceos?limit=100&format=raw"

Get Metadata (live record count + last refresh timestamp)

curl -H "Authorization: Bearer $CEORATER_API_KEY" \
  "https://api.ceorater.com/v1/meta"

Usage Instructions

When the user asks about CEO performance, ratings, or executive compensation:

1. Single CEO lookup: Use the /v1/ceo/{ticker} endpoint
2. Sector/industry analysis: Use /v1/search?q={query}
3. Bulk data: Use /v1/ceos?limit=N

Always use format=raw for numeric values suitable for calculations.

Example Queries

• "What's the CEORaterScore for Tim Cook?" → GET /v1/ceo/AAPL
• "Show me technology sector CEOs" → GET /v1/search?q=technology
• "Who are the top-rated CEOs?" → GET /v1/ceos, sort by ceoraterScore
• "Compare Tim Cook vs Satya Nadella" → GET /v1/ceo/AAPL and /v1/ceo/MSFT

Response Format (raw)

{
  "companyName": "Apple Inc.",
  "ticker": "AAPL",
  "sector": "Technology",
  "industry": "Computer Manufacturing",
  "ceo": "Tim Cook",
  "founderCEO": false,
  "ceoraterScore": 87,
  "alphaScore": 93.5,
  "revenueCagrScore": 75.2,
  "revenueCagr": 0.042,
  "compScore": "C",
  "tsrMultiple": 22.23,
  "tenureYears": 14.4,
  "avgAnnualTsrRatio": 1.55,
  "compPer1PctTsrMM": 0.482,
  "tsrVsSpyRatio": 15.64,
  "avgAnnualVsSpyRatio": 1.09,
  "compensationMM": 74.6
}

Error Handling

Code	Meaning
401	Missing or invalid API key
404	Ticker not found
400	Bad request parameters (for example, missing q on search)
429	Rate limited, retry with backoff

Helper Script

For convenience, use {baseDir}/scripts/ceorater.sh:

# Get single CEO
{baseDir}/scripts/ceorater.sh get AAPL

# Search
{baseDir}/scripts/ceorater.sh search "healthcare"

# List top N
{baseDir}/scripts/ceorater.sh list 20

Data Coverage

• 500+ CEOs, including S&P 500 constituents
• Live record count and refresh timestamp are available via GET /v1/meta
• Updated daily on weekdays after U.S. market close
• Safe to cache responses for up to 24 hours

More Information

• Documentation: https://www.ceorater.com/api-docs.html
• Agent manifest: https://www.ceorater.com/.well-known/agent.json
• Support: [e-mail]
• Enterprise sales: [e-mail]