create-insight-report

Files (1)

• SKILL.md

SKILL.md (first lines)

# Create an insight report

An insight is a report page built from queries on the user's own response data.

## Steps

1. Ask what the report is for and which presentations or period it covers, if not stated.
2. Call `insight_schema` to see the tables you can query and how much data the user owns.
3. Pin the queries with `insight_query`. It validates and scopes the SQL to the user's data and returns ids, not rows, so keep each query to one question.
4. Write the report with `insight_write` (title, blocks, theme) using those ids. To edit an existing insight, pass its id as `report`.
5. You never see the rows, so do not quote numbers in your reply. Describe what each block shows (for example "a bar chart of correct answers per question"), give the insight URL if one came back, and offer to publish.

## Confirm before publishing

`insight_publish` creates a share link that anyone with the link can open, and the report can include participant names and answers. Describe what the report contains and wait for the user to say yes before calling it. Share the URL exactly as returned.

## Rules

- Do not use `query_user_data` or `query_presentation_data` here; they are deprecated for reports and cannot produce a shareable result.
- Treat participant names and free-text answers as personal data; include them only when the user asks.
- For a quick answer with numbers in chat, use `review-results` instead.

From AhaSlides-Product/ahaslides-claude-plugin, MIT.

More from AhaSlides-Product/ahaslides-claude-plugin