An agent skill + ready-made templates for authoring HTML that renders in SharePoint's OneUp HTML viewer and publishing it into a user's own OneDrive / SharePoint.
SharePoint already hosts HTML: save an .html file to OneDrive/SharePoint and it renders in
a sandboxed viewer under a strict CSP. This repo teaches an AI agent (Claude Code, Codex,
Copilot CLI, or any Agent-Skills-compatible client) how to:
- Author HTML that renders — the OneUp CSP + sandbox fail silently, so this skill encodes the rules that make HTML work on first open.
- Embed live SharePoint data — via the
ka-livedata-manifestpattern (no runtime fetch). - Publish — write the
.htmlfile as the signed-in user via Microsoft Graph (primary) or the SharePoint Vroom API (_api/v2.0, when onboarded with a SharePoint token), with a mandatory confirmation before any upload or overwrite.
| Path | What |
|---|---|
SKILL.md |
The agent skill: authoring contract, auth, publish/modify workflow, confirmation gate. |
references/api.md |
Full Graph + Vroom API reference: scopes, token acquisition, request/response schemas, upload sessions. |
references/contract.md |
The OneUp authoring contract in full (CSP, sandbox rules, LiveData). |
assets/templates/dashboard.html |
Self-contained metrics/status dashboard (no external data). |
assets/templates/livedata-dashboard.html |
Live SharePoint data (csv/text/xlsx) via the LiveData manifest. |
scripts/publish-graph.sh |
Helper: publish an HTML file via Microsoft Graph. |
install.sh |
One-command installer (Claude Code, Codex, Copilot CLI). |
This repo follows the open Agent Skills format — it works in any compatible client (Claude Code, Codex, Copilot CLI, and others).
One command — installs for Claude Code, Codex, and Copilot CLI (auto-detects which you have):
curl -fsSL https://raw.githubusercontent.com/SharePoint/sharepoint-html/main/install.sh | shOr via the cross-agent Agent Skills CLI (installs to all detected agents):
npx skills add SharePoint/sharepoint-htmlBoth drop the skill into your agent's user-level skills directory (e.g.
~/.claude/skills/sharepoint-html, ~/.agents/skills/sharepoint-html,
~/.copilot/skills/sharepoint-html) — or clone this repo into that directory by hand. The
skill activates whenever a user asks to create/host/publish/share a web page, dashboard,
report, or diagram in Microsoft 365.
The authoring rules are generated from the live OneUp viewer source and served at your tenant's discovery endpoint:
https://<your-sharepoint-host>/_html— human-readable pagehttps://<your-sharepoint-host>/_html/llms.txt— agent-readable texthttps://<your-sharepoint-host>/_html/help.json— structured JSON
When the viewer's rules change, /_html/llms.txt is the source of truth; the copy in this
repo tracks it.
Publishing writes a real file to the user's OneDrive/SharePoint as that user. The skill requires explicit user confirmation before every upload and overwrite, and never fabricates auth tokens. Nothing is made public unless the user shares it.
MIT — see LICENSE.