SQLBot Workspace Datasource Dashboard Skill

Use this skill when the user wants to operate SQLBot workspaces, datasources, ask-data flows, or dashboards from Claude Code / Agent Skills compatible tools.

This skill wraps the bundled script ${CLAUDE_SKILL_DIR}/sqlbot_skills.py.

Before you run it

1. 1. Check whether ${CLAUDE_SKILL_DIR}/.env exists.
2. If it does not exist, tell the user to copy ${CLAUDE_SKILL_DIR}/.env.example to .env and fill in:

1. 3. For export requests, if Playwright is missing, tell the user to install it with:

CODEBLOCK0

Map the user request to one of these commands

• - List workspaces:

CODEBLOCK1

• - Switch workspace:

CODEBLOCK2

• - List datasources:

CODEBLOCK3

• - Switch datasource:

CODEBLOCK4

• - Ask data:

CODEBLOCK5

or continue an existing chat:

CODEBLOCK6

• - List dashboards:

CODEBLOCK7

Optional flags:

• - INLINECODE7
• INLINECODE8
• INLINECODE9

• - Show dashboard:

CODEBLOCK8

• - Export dashboard:

CODEBLOCK9

or

CODEBLOCK10

Execution rules

• - Prefer exact workspace names or numeric workspace IDs when switching or querying.
• Prefer exact datasource names or numeric datasource IDs when switching or asking.
• Remember that SQLBot dashboard APIs are scoped by the current workspace and current user, so switch workspace before listing or showing dashboards in another workspace.
• Datasource list and ask-data also depend on the current workspace context.
• SQLBot has no standalone datasource-switch API, so datasource switch updates the skill-local state file and ask uses that datasource by default when starting a new chat.
• Preserve the user's requested output path for exports whenever possible.
• If the user does not provide an export path, use the script default (./<dashboard-id>.jpg unless another format is specified).
• Summarize the command output clearly after execution.

Additional resources

• - Detailed usage and installation notes: reference.md
• Repository overview and manual usage examples: README.md