Skip to content

feat(ai): Add SharePoint Embedded agent skills for autonomous setup#216

Open
gnjoseph wants to merge 3 commits into
mainfrom
feature/spe-agent-skills
Open

feat(ai): Add SharePoint Embedded agent skills for autonomous setup#216
gnjoseph wants to merge 3 commits into
mainfrom
feature/spe-agent-skills

Conversation

@gnjoseph
Copy link
Copy Markdown
Collaborator

@gnjoseph gnjoseph commented Apr 22, 2026

Summary

Agent Skills package (agentskills.io spec) for autonomous SharePoint Embedded setup. Two user interactions (az login + browser sign-in), zero portal visits, zero secrets.

What it does

  1. Azure CLI login
  2. Entra app registration (public client, SPE permissions)
  3. Interactive browser auth (auth code + PKCE)
  4. Container type + tenant registration
  5. Container + proof file + preview link

Usage

Agent:

Read AI/skills/full-setup/SKILL.md and set up SPE on my tenant

Manual:

cd AI/skills/full-setup
.\spe-setup.ps1

Prerequisites

Azure CLI, PowerShell 5.1+, tenant admin access

Adds an Agent Skills package (agentskills.io spec) that enables AI coding agents
to set up a complete SharePoint Embedded environment autonomously.

What it does (Steps 1-5):
1. Azure CLI login (interactive browser)
2. Entra app registration with SPE permissions (public client, no secrets)
3. SPE token via interactive browser login (auth code + PKCE, device code fallback)
4. Container type creation + tenant registration
5. Container creation, activation, proof file upload, preview link

Security:
- Interactive auth (auth code + PKCE) as primary flow, not device code
- BYO App validates public client before auth
- Read-Host confirmation before all delete operations
- ExecutionPolicy consent check before running
- v1.0 Graph API endpoints where available (beta-only endpoints documented)

Usage:
  Give an AI agent: 'Read AI/skills/full-setup/SKILL.md and set up SPE on my tenant'
  Or run manually: cd AI/skills/full-setup && .\spe-setup.ps1

Prerequisites: Azure CLI, PowerShell 5.1+, tenant admin access
Comment thread AI/skills/full-setup/_common.ps1
Comment thread AI/skills/SKILL.md Outdated
Comment thread AI/skills/SKILL.md Outdated
Comment thread AI/skills/SKILL.md Outdated
Comment thread AI/skills/SKILL.md Outdated
Comment thread AI/skills/full-setup/SKILL.md Outdated
gnjoseph pushed a commit that referenced this pull request May 14, 2026
- Add User-Agent header (\) to Invoke-GraphRequest in _common.ps1
- Remove broken links to container-management/, content-operations/, billing-setup/ in AI/skills/SKILL.md; add roadmap note
- Fix Skills/ -> skills/ casing in Quick Start code blocks
- Clarify Application Administrator is sufficient (Global Admin not required)
- Rename Step terminology to Stages/substeps in full-setup/SKILL.md and all scripts:
  02-app.ps1 -> Stage 2, Steps 2.1-2.2
  04-container-type.ps1 -> Stage 4, Steps 4.1-4.2
  05-container.ps1 -> Stage 5, Steps 5.1-5.2
  spe-setup.ps1 -> Stage 1-6 wrapper comments

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Greg Joseph and others added 2 commits May 14, 2026 12:43
…bution

Adds a \\\ constant ('spe-agent-skills/1.0 (full-setup)')
and passes it as the UserAgent parameter on every Invoke-GraphRequest call,
so Graph telemetry can attribute traffic to this skill.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Remove broken links (container-management/, content-operations/, billing-setup/) from AI/skills/SKILL.md; add roadmap note
- Fix Skills/ -> skills/ casing in Quick Start code blocks
- Clarify Application Administrator is sufficient (Global Admin not required)
- Rename Step terminology to Stages/substeps in full-setup/SKILL.md and scripts:
  02-app.ps1, 04-container-type.ps1, 05-container.ps1, spe-setup.ps1

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@gnjoseph gnjoseph force-pushed the feature/spe-agent-skills branch from aff9137 to f5c4b80 Compare May 14, 2026 19:43
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