fabric-semantic-model

Fabric Semantic Model

Plugin repository for Microsoft Fabric semantic model skills used by Claude Code and Codex.

This repository is a single plugin source repo, not a marketplace repo.

• Claude and Codex marketplaces should point to this repo as the plugin source.
• The canonical skill content lives in skills/.

Skills

• designing-semantic-model — design Microsoft Fabric semantic models and scaffold TMDL from dbt-first project context.
• authoring-dax-measures — author DAX measures for Fabric and Power BI semantic models using TMDL syntax.
• validating-semantic-model — validate TMDL semantic models for structure, relationships, measures, naming, performance, and dbt alignment.

Layout

.
├── .claude-plugin/plugin.json      # Claude plugin manifest
├── .codex-plugin/plugin.json       # Codex plugin manifest
├── skills/
│   ├── authoring-dax-measures/
│   ├── designing-semantic-model/
│   └── validating-semantic-model/
├── tests/evals/
│   ├── packages/                   # One eval package per skill
│   ├── prompts/                    # Eval prompts
│   ├── assertions/                 # Shared assertion helpers
│   └── scripts/                   # Eval runner scripts
└── README.md

Use In Claude

Install through a Claude plugin marketplace pointing to this repo, or symlink locally:

mkdir -p ~/.claude/skills

ln -s /absolute/path/to/fabric-semantic-model/skills/designing-semantic-model \
  ~/.claude/skills/designing-semantic-model

Enable the pre-commit hook:

git config core.hooksPath .githooks
chmod +x .githooks/pre-commit

Validate the Claude plugin metadata:

claude plugin validate .
python3 scripts/validate_plugin_manifests.py

Use In Codex

Install through a Codex plugin marketplace pointing to this repo, or symlink locally:

mkdir -p ~/.codex/skills

ln -s /absolute/path/to/fabric-semantic-model/skills/designing-semantic-model \
  ~/.codex/skills/designing-semantic-model

Codex CLI marketplace registration is performed against a marketplace repo or marketplace checkout that lists this plugin source repo. Do not register this plugin source repo directly as the marketplace root.

Validate the Codex manifest alongside the Claude manifest:

python3 scripts/validate_plugin_manifests.py
codex plugin marketplace --help

Eval Harness

Promptfoo evals live under tests/evals/.

cd tests/evals
npm install
npm run eval

Individual skill suite:

cd tests/evals
npm run eval:designing-semantic-model

Development Notes

• Keep all skill directories under skills/.
• Keep skill assets, references, and scripts inside the owning skill directory.
• Avoid cross-repo relative paths — a plugin install is expected to be self-contained.
• Keep .claude-plugin/plugin.json and .codex-plugin/plugin.json on the same plugin name and version.
• Bump both manifest versions together with every plugin content or metadata PR (enforced by CI).
• Validate plugin metadata before opening a PR:

python3 scripts/validate_plugin_manifests.py
python3 scripts/check_plugin_version_bump.py --base-ref origin/main
python3 -m unittest discover -s tests