ktx/skills/ktx
Andrey Avtomonov 5faa16b32c
docs(ktx skill): harden setup guidance from agent-driven demo run (#247)
Fold field-tested fixes into the ktx skill, verified against current CLI source:

- prefer file: secret refs over env: (env: re-resolves per-process and resolves
  empty in later ingest/mcp shells)
- pass --skip-agents on data-only setup runs; explain the trailing agent step's
  misleading exit 1 on otherwise-successful runs
- dbt ignores --source-warehouse-connection-id (maps by table name); required
  only for Metabase/Looker/LookML
- never go silent during slow setup/ingest: poll .ktx mtimes and post progress
  so a long run does not look stuck
- judge readiness from verdict, connections[].status, localStats.semanticLayer
  and wikiPages; perConnection under-reports
- add troubleshooting entries for the 'Run in a TTY' exit 1 and secrets that
  resolve empty only during ingest/mcp
2026-06-01 12:08:58 +00:00
..
agents docs: add ktx skills.sh setup skill (#227) 2026-05-28 12:28:10 +02:00
SKILL.md docs(ktx skill): harden setup guidance from agent-driven demo run (#247) 2026-06-01 12:08:58 +00:00
troubleshooting.md docs(ktx skill): harden setup guidance from agent-driven demo run (#247) 2026-06-01 12:08:58 +00:00