Run regime aware screen

Skill secapi-ai/secapi-skills/run-regime-aware-screen

SEC API agent skills for source-cited filing research with hosted API and MCP workflows

Install

npx -y skills add secapi-ai/secapi-skills --skill run-regime-aware-screen

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Researches factor rotation in a stated country's macro regime. Use when you need dated leaders and laggards with regime context, not an individual-security recommendation.

SKILL.md

1.7 KB, as published. Nobody here has run it

Run Regime-Aware Screen

Place factor rotation in country and time context. Report the observed regime and screen output before interpreting either.

First Read

curl --fail --silent --show-error https://api.secapi.ai/v1/strategies/factor-rotation \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "content-type: application/json" \
  -d '{"country":"US","category":"style","window":"1m","lookback":"6m","limit":5}'

The published request supports country, category, window, lookback, and limit. Use GET /v1/macro/regimes to add the country's returned regime context.

What to provide

Give the agent a country, factor category, window, lookback, and desired result count. These settings determine the screen. The result is a dated ranking, not a substitute for issuer-level research.

Research path

Read GET /v1/macro/regimes?country=US for the country in scope; it also accepts optional lookback controls.
Submit the factor-rotation request with the country, category, window, lookback, and limit you intend to report.
Preserve returned dates, country, ranking, regime context, rationale, and disclosures when supplied.

Expected result

State the observation time, country, regime context, leaders, and laggards before offering interpretation. Explain the limits of the selected window and do not turn a ranking into a durable business thesis or investment recommendation. Rankings and regimes can change with the underlying data.