> AI agents: this is one page of nextanalytica's docs. The full index for agents: https://nextanalytica.app/llms.txt

# Insights

> Signals from our rules and findings from your skills, newest first, with the numbers that prove them.

Updated: 2026-11-17

An insight is something worth knowing about your project, with its numbers and the query that proves it. Your agent lists them with `list_insights`.

## Where do insights come from?

| | Our rules (signals) | Your skills (findings) |
| --- | --- | --- |
| Run | On our side, without a model | On your team's Claude |
| When | Once a day, after the day before closes | On the skill's schedule |
| Looks at | One fixed pattern, such as spend with no conversion | Whatever the instructions say |
| Reaches | Everyone who added the skill the rule belongs to | The skill's owner |
| Tuned by | Adding or removing the skill | Editing the skill |

Rules are fast and cheap but narrow; skills read the context and explain. You want both, and they work together: a rule fires, then the skill's run explains it.

## What can I do with one?

- Ask about it: "Tell me more about the spend alert."
- Dismiss it: `mark_insight` keeps the subject quiet for you for **30 days**.
- Act on it: see [Acting on a finding](/docs/skills/acting-on-findings).

## Next step

[Findings](/docs/skills/findings)

Canonical address: https://nextanalytica.app/docs/skills/insights
