Skip to content

docs(skill): workflows, references, and SKILL alignment#35

Merged
pthurlow merged 1 commit intomainfrom
docs/skill-workflows-references
Apr 9, 2026
Merged

docs(skill): workflows, references, and SKILL alignment#35
pthurlow merged 1 commit intomainfrom
docs/skill-workflows-references

Conversation

@eddietejeda
Copy link
Copy Markdown
Contributor

@eddietejeda eddietejeda commented Apr 3, 2026

Summary

Adds Agent Skills references/ docs and extends SKILL.md so multi-step patterns are discoverable without new CLI commands.

New files (skills/hotdata-cli/references/)

  • WORKFLOWS.md — Model, Library, History, Chain, and Indexes (analyze workload vs indexes list, create indexes with guardrails). Project-owned paths (DATA_MODEL.md, optional logs).
  • MODEL_BUILD.md — Optional deep data-model pass (catalog refresh order, vendor/ELT + dlt enrichment, relationships, search/index awareness, rules). No Fivetran-specific references.
  • DATA_MODEL.template.md — Copy-to-project template (overview, per-table blocks, datasets vs Chain tables, search summary); notes on broken links when copied out of the bundle.

SKILL.md

  • Multi-step workflows section with links to the above and WORKFLOWS.md#indexes.
  • Project-owned model files (DATA_MODEL.md / data_model.md).
  • Aligns with current CLI where not already on main: queries update (--category, --table-size, empty string clears), Query results (list + get), auth logout, pointer to connections new / skills / completions.
  • Refresh connection schema kept as merged on main (resolved duplicate heading vs stash).

- Add references/WORKFLOWS.md (Model, Library, History, Chain, Indexes)
- Add references/MODEL_BUILD.md for deep data-model builds; vendor-neutral enrichment
- Add references/DATA_MODEL.template.md for project-owned model docs
- Extend SKILL.md: multi-step workflow index, links to references; keep refresh
  section from main; queries update flags; query results list+get; auth logout
  and other commands note
@sentry
Copy link
Copy Markdown

sentry bot commented Apr 3, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@pthurlow pthurlow merged commit 413ecec into main Apr 9, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants