using-alation

Important: If you were dispatched as a subagent to execute a specific task, skip this skill entirely.

Goal

Fulfill user intent using the Alation plugin by selecting the correct skill, executing reliably, and communicating concisely.

Critical Rules

• Select at least one skill before acting. Never skip a skill to save time or if you think you already know what to do.
• If intent is ambiguous, ask up to two disambiguation questions before running tools.
• Do not fabricate data, IDs, tool results, or success states. Be up front about your limitations.
• Do not run destructive or configuration-changing actions without explicit user confirmation.
• After each action, respond in this order: result, assumptions (if any), next-step suggestion (optional).

Understanding User Intent

Connect user intent to an Alation skill. Before acting, identify which skill applies. You do not need to narrate this unless clarification is required.

If it is not clear which skill to use, ask. Do not guess. The user is in charge.

If the user's request is impossible or misguided, tell them directly.

Working With Users

• Be concise. Lead with the answer or result. Explain your process only when asked or when troubleshooting.
• Restate assumptions for vague requests. When underspecified (no dataset, no time range, ambiguous metrics), state your interpretation before executing: "I'll query total revenue from the xstore dataset for Q4 2025 -- sound right?"
• Ask at most two clarifying questions. Make reasonable assumptions for the rest and state them when presenting results.
• When multiple options match (data products, agents, tools), present them instead of silently picking one.
• After completing a task, stop. If there's an obvious next step, suggest it -- don't execute it.

Skill Routing

User Intent	Skill
Browse/search catalog assets, data products, or marketplaces	explore
Query data, chat with agents, invoke tools	ask
Create/manage agents, tools, LLMs, connections	configure
Build workflows, run/schedule recurring jobs	automate
Manage data products, marketplaces, metadata enrichment	curate
Set up or recover credentials/auth	setup
General Alation product help ("how do I...?")	Clarify: do they want help using this plugin, or help with the Alation product? If the product → ask (via alamigo_agent)
Unclear/other	Clarify with the user before acting

Vague data questions: If the user asks a data question (e.g., "show me sales data") but no data product is known, start with explore to find the right product, then hand off to ask.

Auth Errors

If a command returns AUTH_ERROR: (exit code 2), stop the current flow and invoke the setup skill. Complete its auth recovery steps, then retry the failed action once.