fabric-apps

Fabric Apps skill for Claude Code

A Claude Code skill for building data-driven applications on Microsoft Fabric Apps (the preview workload powered by the Rayfin toolchain).

Microsoft Fabric Apps turns TypeScript data models into a managed SQL database, an auto-generated GraphQL Data API, row-level authorization, and static hosting — all behind a single endpoint with Microsoft Entra SSO. This skill teaches Claude the real @microsoft/rayfin-* API so it stops inventing decorators and client methods.

Why it helps: Fabric Apps is new enough that, without this skill, Claude confidently hallucinates the API — wrong decorators (@field, @owner, @relation), a fictional client.notes.count(), offset pagination that doesn't exist, etc. In benchmarking, the skill took a held-out task suite from ~21% correct to 100% with no speed penalty.

What it covers

• SKILL.md — the build workflow (scaffold → model → authorize → consume → deploy), core decorators and client usage inline, the common gotchas, and a "verify against live docs, it's preview" guardrail.
• references/data-modeling.md — every field decorator, type modifiers, relationships/foreign keys, and the full @role / policy / field-permission system.
• references/client-api.md — RayfinClient init, read/filter/sort/relationship-navigation, cursor pagination, CRUD, auth, and current limitations.
• references/cli-and-config.md — full Rayfin CLI command + flag reference, the rayfin.yml service schema, project structure, env vars, and the deployment sequence.

All content is grounded in the official Microsoft Learn documentation.

Install

Option A — as a plugin (recommended, updatable)

In Claude Code:

/plugin marketplace add NikolajUnserRichter/fabric-apps-skill
/plugin install fabric-apps@fabric-apps-marketplace

Pull future updates with /plugin marketplace update fabric-apps-marketplace.

Option B — as a personal skill (manual)

git clone https://github.com/NikolajUnserRichter/fabric-apps-skill.git
mkdir -p ~/.claude/skills
cp -r fabric-apps-skill/skills/fabric-apps ~/.claude/skills/

The skill becomes available in every project, no restart needed.

Option C — as a project skill (share with a team via a repo)

Copy skills/fabric-apps/ into a repo your team clones, under .claude/skills/fabric-apps/, and commit it. Everyone working in that repo gets the skill automatically.

Using it

Just describe Fabric Apps / Rayfin work and Claude will pull the skill in — e.g.:

• "scaffold a Fabric app with a Note entity that belongs to a Notebook"
• "add owner-only permissions to my Task entity so users only see their own rows"
• "how do I paginate RayfinClient results and get a total count?"
• "npx rayfin up db apply warns about destructive changes — how do I apply safely?"

It will not trigger for unrelated "Fabric" topics (Azure Service Fabric, Fabric notebooks/lakehouses/pipelines, Power BI) — those are deliberately excluded.

Prerequisites (for actually deploying)

This skill is knowledge, not a license. To deploy a real Fabric app you still need:

• A Fabric workspace with Fabric capacity assigned.
• A tenant admin to enable the "Fabric Apps (preview)" workload in the Fabric admin portal.

A note on the preview API

Fabric Apps is in preview; Microsoft may change the SDK. The skill instructs Claude to verify decorator names, client signatures, and CLI flags against the live docs before generating non-trivial code, so it degrades gracefully — but the reference files may eventually need a refresh.

License

MIT — see LICENSE.