Skip to content

docs(iblai-analytics): delegate REST reference to the iblai/api companion#139

Open
xyzeem wants to merge 1 commit into
iblai:mainfrom
xyzeem:docs/iblai-analytics-live-with-api
Open

docs(iblai-analytics): delegate REST reference to the iblai/api companion#139
xyzeem wants to merge 1 commit into
iblai:mainfrom
xyzeem:docs/iblai-analytics-live-with-api

Conversation

@xyzeem

@xyzeem xyzeem commented Jul 1, 2026

Copy link
Copy Markdown

The iblai-analytics vibe skill carried a 150-line inline REST reference — endpoint tables under /api/ai-analytics/* that don't resolve against Data Manager, plus RBAC prose that leaked internal Django class names. Rather than maintain a duplicate reference that's already regrounded in iblai/api, this PR removes the inline section and points at the companion skill as the single source of truth. The vibe skill returns to its actual job: wiring the SDK's AnalyticsLayout and sub-page components into a Next.js app.

Installing the companion is one step (npx skills add iblai/api), and the frontmatter description now signals the pairing so the router picks the right skill for the task. {dm_url} (= https://api.iblai.app/dm) is named as the anchor in both files so they read as one system. Cursor and Codex adapters are regenerated from the canonical SKILL.md.

…nion

The vibe iblai-analytics skill previously carried a 150-line inline
REST reference — endpoint tables under /api/ai-analytics/* that
don't resolve against Data Manager, plus RBAC prose that leaked
internal Django class names. Remove the duplicate reference and
point at the companion /iblai-analytics skill in iblai/api as the
single source of truth.

The vibe skill returns to its actual job: wiring the SDK's
AnalyticsLayout and sub-page components into a Next.js app.
Installing the companion is one step (npx skills add iblai/api);
the frontmatter description now signals the pairing so the router
picks the right skill for the task. {dm_url}
(= https://api.iblai.app/dm) is named as the anchor in both files
so they read as one system.

Cursor and Codex adapters regenerated from the canonical SKILL.md.
Then `/iblai-analytics` covers auth, the schema-first workflow, the
analyst-shaped endpoint groupings (Overview / Costs / Users & engagement
/ Topics & conversations / Transcripts / Sessions & ratings / Course /
Program / Pathway & skill / Per-learner / Time-on-platform), the async

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Per-User?

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.

3 participants