@secapi/skills

Standalone distributable package of the 8 SEC API skills for Claude Code and compatible AI agents.

Each skill is a structured prompt that teaches an agent how to use the SEC API to accomplish a specific financial-analysis workflow. Skills include a SKILL.md (the prompt itself), install.md (setup instructions), and metadata.json (structured metadata for programmatic discovery).

Prerequisites

• An SEC API key (set as SECAPI_API_KEY or configure per the install instructions)
• Claude Code or a compatible agent that supports skill installation

Installation

Any agent (recommended)

Install across Claude Code, Cursor, Codex, and ~70 other agents with the universal skills installer:

npx skills add secapi-ai/secapi-skills --global

Claude Code (per-skill)

claude skill install @secapi/skills/skills/<skill-name>

For example:

claude skill install @secapi/skills/skills/analyze-company-in-context

npm (programmatic access)

npm install @secapi/skills

Then in your code:

const { listSkills, getSkill, getSkillPrompt } = require("@secapi/skills");

// List all skills
const skills = listSkills();

// Get a specific skill's prompt
const prompt = getSkillPrompt("analyze-company-in-context");

Skills

| Skill | Description | |-------|-------------| | analyze-company-in-context | Build issuer and security context packs with SEC API intelligence bundles plus factor and macro overlays. | | decompose-return-and-hedge | Explain a stock's return with factor decomposition, loadings, and hedge ideas. | | investigate-filing-footnotes | Use the semantic planner and intelligence bundles to investigate filing footnotes and accounting-risk areas. | | make-portfolio-factor-neutral | Analyze portfolio exposures, generate neutralization plans, and validate them with stress scenarios. | | run-regime-aware-screen | Screen factors and candidates against the active macro regime and rotation backdrop. | | track-insiders-and-13fs | Analyze insider activity and institutional ownership changes, including manager style drift. | | use-live-factor-dashboard | Power a live factor dashboard with intraday returns, stock loadings, and model-portfolio drill-down. | | write-country-regime-report | Build allocator-style country reports from the high-signal pack, macro regime state, and country-report endpoint. |

Skill structure

Each skill directory contains:

• SKILL.md — The prompt that teaches the agent the workflow
• install.md — Setup and configuration instructions
• metadata.json — Structured metadata (name, description, tags, triggers, required endpoints)

License

MIT