> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Dividend Analysis

> Compare dividend yield, payout safety, and income quality.

[View on GitHub ->](https://github.com/AIsa-team/agent-skills/tree/main/stock-dividend)

**Dividend research for income ideas.** Compare yield, payout safety, growth, and related metrics without connecting brokerage accounts.

## Install

First, install the AIsa CLI if you have not already:

```bash theme={null}
npm install -g @aisa-one/cli
```

Then install the skill:

```bash theme={null}
aisa skills install stock-dividend
```

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Yield review" icon="percent">
    Compare yield against payout and business quality.
  </Card>

  <Card title="Payout safety" icon="shield-check">
    Check whether dividends appear sustainable.
  </Card>

  <Card title="Growth history" icon="arrow-trend-up">
    Review dividend growth and track records.
  </Card>

  <Card title="Income quality" icon="coins">
    Summarize cash-flow support and risk factors.
  </Card>
</CardGroup>

## Usage

```bash theme={null}
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-dividend/scripts/dividends.py" JNJ
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-dividend/scripts/dividends.py" JNJ PG KO
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-dividend/scripts/dividends.py" JNJ PG KO --output json
```

### Arguments

* **Tickers**: One or more dividend-paying stock symbols. Inputs are validated before they are sent to the model.
* `--output json`: Append structured JSON summary

## Permission Boundary

* The only required secret is `AISA_API_KEY`.
* Requests go to `https://api.aisa.one/v1` by default.
* `AISA_BASE_URL` is optional and should only point to a trusted AIsa-compatible HTTPS endpoint.
* Do not provide brokerage credentials, trading passwords, cookies, or payment details. This skill has no purchase or order-placement workflow.

## Analysis Output

For each ticker, the analysis includes:

* **Core Metrics**: Yield, ex-date, frequency, last payment amount
* **Payout Analysis**: Payout ratio, FCF payout, coverage ratio
* **Growth**: 1Y, 3Y CAGR, 5Y CAGR, consecutive years of increases
* **Last 5 Annual Dividends** table
* **Safety Score (0-100)**: Based on payout ratio (25pts), FCF coverage (20pts), growth consistency (20pts), balance sheet (15pts), earnings stability (10pts), consecutive years (10pts)
* **Income Rating**: Excellent (80+), Good (60-79), Moderate (40-59), Poor (\<40)
* **Dividend Aristocrat/King** status check

When multiple tickers are provided, a ranked comparison table is included.

**NOT FINANCIAL ADVICE.** For informational purposes only.

## Get started

1. Sign up at [aisa.one](https://aisa.one) (new accounts start with \$2 free credit).
2. Generate an API key from the console.
3. Set your key and install the skill:
   ```bash theme={null}
   export AISA_API_KEY="your-key"
   npm install -g @aisa-one/cli
   aisa skills install stock-dividend
   ```
4. Start a new agent session so the runtime loads the updated skill instructions.

## Related

<CardGroup cols={3}>
  <Card title="MarketPulse" icon="chart-line" href="/agent-skills/marketpulse">
    Financial statements and market data.
  </Card>

  <Card title="Stock & Crypto Analysis" icon="file-chart-line" href="/agent-skills/stock-analysis">
    Broader asset analysis workflow.
  </Card>

  <Card title="Portfolio Management" icon="wallet" href="/agent-skills/stock-portfolio">
    Track portfolio allocation and P\&L.
  </Card>
</CardGroup>