Dataverse-skills CLAUDE.md

CLAUDE.md — Dataverse Skills Plugin

What This Repo Is

This repo ships a plugin for Claude Code and GitHub Copilot that provides AI-assisted Dataverse / Power Platform development. The plugin consists of skill files (SKILL.md) that teach the agent how to use the Python SDK, PAC CLI, MCP server, and Dataverse Web API.

The plugin is loaded via:

claude --plugin-dir .github/plugins/dataverse

Skill files live under .github/plugins/dataverse/skills/<skill-name>/SKILL.md.

---

Before Committing

Run the static eval suite. It checks every skill file for code correctness, auth pattern compliance, and routing consistency:

python .github/evals/static_checks.py

Exit code 0 = all checks pass. Fix any failures before committing. The checks run in under a second and have no external dependencies.

---

Skill Authoring Rules

Python only

All code examples in skill files must be Python. No JavaScript, TypeScript, PowerShell, or shell one-liners that substitute for Python logic.

Auth pattern

Every standalone Python block that imports from auth must use one of these patterns:

import os, sys
sys.path.insert(0, os.path.join(os.getcwd(), "scripts"))
from auth import get_client                       # PREFERRED — SDK with plugin attribution
# OR
from auth import get_plugin_headers, get_token    # Raw Web API WITH skill attribution
# OR
from auth import get_token, load_env              # Raw Web API, no attribution (last resort)

get_client(skill) is the preferred entry point — it handles auth, environment URL, and plugin attribution (User-Agent tagging) in one call. get_token() is only for raw Web API calls that no managed surface covers (e.g., an in-process Python loop issuing many attributed requests in one session) — and for those, prefer get_plugin_headers(skill, get_token()), which stamps the same skill attribution the SDK path carries (a bare get_token() does not). Forms, views, and settings are ordinary entities served by the SDK (client.records.*), not urllib. Never use get_token() in a block containing DataverseClient(.