Official agent skill

Add Sharepoint

by microsoft in microsoft/power-platform-skills

A skill your agent uses when the user wants to read or write SharePoint lists, manage documents in a SharePoint document library, or create a new SharePoint list from a Power Apps mobile app.

OfficialMITAuto-check: notesDocuments & Office

Install Add Sharepoint

skills CLI
$ npx skills add microsoft/power-platform-skills --skill add-sharepoint -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install microsoft/power-platform-skills add-sharepoint --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/microsoft/power-platform-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/mobile-apps/skills/add-sharepoint .claude/skills/add-sharepoint && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
add-sharepoint
GitHub stars
972
Token cost
~2.1k tokens
SKILL.md length
714 words
Files
4 (incl. references)
Skills in repo
87
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants to read or write SharePoint lists, manage documents in a SharePoint document library, or create a new SharePoint list from a Power Apps mobile app.

  • Works in 12 steps: Check Memory Bank → Plan → Setup Graph API Auth (if creating lists) → …
  • The user wants to read
  • Calls npm, npx and az; reaches contoso.sharepoint.com and make.powerapps.com
  • Write SharePoint lists

What it does

Add Sharepoint is an agent skill from microsoft/power-platform-skills, published by the product's own GitHub organization. Use when the user wants to read or write SharePoint lists, manage documents in a SharePoint document library, or create a new SharePoint list from a Power Apps mobile app.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/api-authentication-reference.md`, `references/list-management-reference.md` and `references/sharepoint-reference.md`).

It sits in Documents & Office, covering Cloud office suites. It works with Microsoft SharePoint. The repository describes itself as: A plugin marketplace for GitHub Copilot and other AI agents that provides Power Platform development plugins, including reusable skills, agents, and commands for building and… The licence is MIT.

When your agent uses it

  • The user wants to read
  • Write SharePoint lists
  • Manage documents in a SharePoint document library
  • Create a new SharePoint list from a Power Apps mobile app

Example prompts

  • “/add-sharepoint”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): Read, Edit, Write, Grep, Glob, Bash, AskUserQuestion, EnterPlanMode, ExitPlanMode

Workflow steps

12 steps, taken from the step headings in SKILL.md.

  1. Check Memory Bank
  2. Plan
  3. Setup Graph API Auth (if creating lists)
  4. Review Existing Lists (if creating lists)
  5. Create Lists (if creating lists)
  6. Get Connection ID
  7. Discover Sites
  8. Discover Tables
  9. Add Connector
  10. Configure
  11. Type-check
  12. Update Memory Bank

What it can do on your machine

Read from SKILL.md and the folder at commit 0d044b8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Edit
    • Write
    • Grep
    • Glob
    • Bash
    • AskUserQuestion
    • EnterPlanMode
    • ExitPlanMode

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • npx
    • az
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • contoso.sharepoint.com
    • make.powerapps.com
    • graph.microsoft.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Add Sharepoint loads about 2.1k tokens when it runs, and up to ~7.9k if it reads all its reference files. Until then it costs about 47 tokens; SKILL.md has 714 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Edit, Write, Grep, Glob, Bash, AskUserQuestion, EnterPlanMode, ExitPlanMode

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from microsoft/power-platform-skills at commit 0d044b8, republished under its MIT licence (© microsoft). 714 words, ~2,107 tokens.

Download SKILL.mdSave it as .claude/skills/add-sharepoint/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
add-sharepoint
description
Use when the user wants to read or write SharePoint lists, manage documents in a SharePoint document library, or create a new SharePoint list from a Power Apps mobile app.
allowed-tools
Read, Edit, Write, Grep, Glob, Bash, AskUserQuestion, EnterPlanMode, ExitPlanMode
user-invocable
true
model
sonnet

Plugin check: Run node "${PLUGIN_ROOT}/scripts/check-version.js" - if it outputs a message, show it to the user before proceeding.

📋 Shared instructions: shared-instructions.md — read first.

References:

Add SharePoint

Two paths: existing lists (skip to Step 6) or new lists (full workflow).

Workflow

  1. Check Memory Bank → 2. Plan → 3. Setup Graph API Auth → 4. Review Existing Lists → 5. Create Lists → 6. Get Connection ID → 7. Discover Sites → 8. Discover Tables → 9. Add Connector → 10. Configure → 11. Type-check → 12. Update Memory Bank

Step 1: Check Memory Bank

Check for memory-bank.md per shared-instructions.md.

Also confirm this is a mobile app:

bash
test -f power.config.json && test -f app.config.js && echo "OK" || echo "ERROR: not a mobile app"
Step 2: Plan

Telemetry checkpoint: plan_sharepoint_data_source

Ask the user:

  1. Which SharePoint list(s) do they need?
  2. Do the lists already exist on their site, or do they need to create new ones?

If lists already exist: Skip to Step 6.

If creating new lists:

  • Ask about the data they need and design an appropriate schema
  • Reuse existing lists when possible (don't duplicate)
  • Enter plan mode with EnterPlanMode, present the list designs with columns and types
  • Get approval with ExitPlanMode
Step 3: Setup Graph API Auth (if creating lists)

See api-authentication-reference.md for full details.

powershell
az account show   # Verify Azure CLI logged in

$api = Initialize-SharePointGraphApi -SiteUrl "https://<tenant>.sharepoint.com/sites/<site-name>"
$headers = $api.Headers
$siteId = $api.SiteId

Requires Sites.Manage.All permission.

Step 4: Review Existing Lists (if creating lists)

Always query existing lists first before creating:

powershell
$existingLists = Invoke-RestMethod -Uri "https://graph.microsoft.com/v1.0/sites/$siteId/lists?`$select=id,displayName,description,list&`$filter=list/hidden eq false" -Headers $headers

See list-management-reference.md for Find-SimilarLists, Compare-ListSchemas, and Get-ListSchema functions.

Present findings to user with AskUserQuestion:

  • Lists that can be reused (already exist with matching columns)
  • Lists that need extension (exist but missing columns)
  • Lists that must be created (no match found)
Step 5: Create Lists (if creating lists)

Telemetry checkpoint: create_sharepoint_lists

Print before starting:

"→ Creating SharePoint lists via Graph API (sequential per list, columns added after list exists)…"

Get explicit confirmation before creating. Use safe functions from list-management-reference.md:

  • New-SharePointListIfNotExists
  • Add-SharePointColumnIfNotExists
  • Add-SharePointLookupColumn (for cross-list references)
Step 6: Get Connection ID

Get the SharePoint Online connection ID (see connector-reference.md):

bash
$PA connection create --connector shared_sharepointonline --json

Use shared_sharepointonline as the apiId and capture connectionId from the output. Use these exact values in the commands below.

If pa connection create cannot complete because browser-based connection creation is disabled or the connector needs interactive auth, direct the user to create one:

Open https://make.powerapps.com/environments/<environment-id>/connections → + New connection → search "SharePoint" → Create. Then provide the connection ID or rerun /list-connections shared_sharepointonline.

Show full SKILL.md (329 more words)Show less
Step 7: Discover Sites

Print before starting:

"→ Discovering SharePoint sites accessible to this connection…"

bash
$PA connection list-datasets --connector <apiId-from-list> --connection-id <connection-id> --json

Present the sites to the user and ask which one(s) they want to connect to. If the user already specified a site URL, confirm it appears in the list.

If pa connection list-datasets fails or returns no results:

  • Auth, wrong user, or multiple accounts: follow shared-instructions command-failure handling and retry once.
  • Empty list: Confirm the connection ID is for a SharePoint Online connection and the user has access to at least one site. STOP if the list is empty after confirming.
Step 8: Discover Tables

Print before starting:

"→ Discovering lists/document libraries on each selected site…"

For each selected site:

bash
$PA connection list-tables --connector <apiId-from-list> --connection-id <connection-id> --dataset '<site-url>' --json

Present the tables to the user and ask which ones they want to add. Suggest tables that look relevant to their use case. If lists were created in Step 5, they should appear here.

Step 9: Add Connector

Telemetry checkpoint: generate_sharepoint_data_source

Print before starting:

"→ Running pa app add data-source per list (sequential, ~10–20 seconds each)."

SharePoint is a tabular datasource — requires --connection-id, --dataset, and --table:

bash
$PA app add data-source --connector <apiId-from-list> --connection-id <connectionId-from-list> --dataset '<site-url>' --table '<table-name>'

Run once per list or document library.

Step 10: Configure

Read sharepoint-reference.md before writing any SharePoint code — column encoding, choice fields, and lookups have critical gotchas.

Use Grep to find methods in src/generated/services/SharePointOnlineService.ts (generated files can be very large — see connector-reference.md).

Sample usage:

typescript
import { SharePointOnlineService } from '../../src/generated/services/SharePointOnlineService';

// Read items
const result = await SharePointOnlineService.GetItems({
  dataset: 'https://contoso.sharepoint.com/sites/projects',
  table: 'Project Milestones',
});
const items = result.value ?? [];

// Create item
await SharePointOnlineService.PostItem({
  dataset: 'https://contoso.sharepoint.com/sites/projects',
  table: 'Project Milestones',
  item: { Title: 'Launch review', Status: 'Not Started' },
});

// Update item (SharePoint IDs are integers, not GUIDs)
await SharePointOnlineService.PatchItem({
  dataset: 'https://contoso.sharepoint.com/sites/projects',
  table: 'Project Milestones',
  id: 42,
  item: { Status: 'Done' },
});
Step 11: Type-check

Telemetry checkpoint: validate_sharepoint_integration

Print before starting:

"→ Regenerating connector schemas + running tsc to verify SharePoint services compile (~15–30 seconds)."

Native diff: npx --no-install tsc --noEmit instead of npm run build. Do NOT run platform-specific native build commands here.

pa app add data-source wrote new files into .power/schemas/sharepointonline/. Regenerate connectorSchemas.ts before type-checking so the new list is wired into the runtime schema map:

bash
npm run generate-schemas
npx --no-install tsc --noEmit

Fix TypeScript errors before proceeding.

Step 12: Update Memory Bank

Update memory-bank.md with: connector added, site URL, lists/libraries connected (or created), type-check status.

Note: No manual executor wiring needed. PowerAppsProvider in app/_layout.tsx handles SharePoint connector routing, connection resolution, and OAuth consent automatically at runtime.

© microsoft, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in plugins/mobile-apps/skills/add-sharepoint of microsoft/power-platform-skills.

  • SKILL.md
  • references/api-authentication-reference.md
  • references/list-management-reference.md
  • references/sharepoint-reference.md

Open the folder on GitHubat commit 0d044b8

Compare with similar skills

Add Sharepoint next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Add Sharepoint compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Add Sharepoint this skillmicrosoft/power-platform-skills972—~2.1kAutomated safety check: NotesMIT
Colleague DistillationZhixiangLuo/10xProductivity478—~2.1kAutomated safety check: NotesMIT
Msgraphcodemie-ai/codemie-code294—~4.1kAutomated safety check: PassApache-2.0
aai-cli Microsoft 365aai-labs/agent-barn109—~1.2kAutomated safety check: PassApache-2.0
Workiqmicrosoft/work-iq1k—~15kAutomated safety check: PassCustom licence
Analyze Document Librarypnp/sharepoint-skills131—~899Automated safety check: PassMIT

Similar skills

  • Colleague Distillation

    ZhixiangLuo/10xProductivity

    Distill a colleague into a reusable AI skill (work + persona) using tool connections — Slack, Slack AI, Jira, GHE, Bitbucket, Confluence, SharePoint, Teams, Outlook, Notion, Linear, Google Docs, and…

    478 GitHub stars~2.1k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check: notes
  • Msgraph

    codemie-ai/codemie-code

    Work with Microsoft 365 services via the Graph API — emails, calendar events, SharePoint sites (read and write), Teams chats and channel messages, OneDrive files, OneNote notebooks, Planner task…

    294 GitHub stars~4.1k tokensUpdated today
    Documents & OfficeAuto-check passed
  • aai-cli Microsoft 365

    aai-labs/agent-barn

    Guides work with Outlook, OneDrive, SharePoint, Teams, Excel, To Do and Planner through aai-cli's Microsoft Graph commands, starting from which service owns the data.

    109 GitHub stars~1.2k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Workiq

    microsoft/work-iq

    Official

    WorkIQ tools for Microsoft 365 workplace data and actions. An agent skill from microsoft/work-iq.

    1k GitHub stars~15k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Analyze Document Library

    pnp/sharepoint-skills

    Analyze the current SharePoint document library in read-only mode and produce a structured summary of files, folders, file types, recent activity, naming issues, and organization recommendations.

    131 GitHub stars~899 tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Broken Link Auditor

    pnp/sharepoint-skills

    Audits SharePoint pages, news posts, and hyperlink fields for broken or risky links and saves a self-contained HTML link-health report to the site.

    131 GitHub stars~2.5k tokensUpdated yesterday
    Documents & OfficeAuto-check passed

More from microsoft/power-platform-skills

All 87 skills in this repo
  • Manage Firewall

    microsoft/power-platform-skills

    Official

    Inspects and configures the web application firewall (WAF) in front of a Power Pages production site.

    972 GitHub stars~4.5k tokensUpdated today
    Auto-check: notes
  • Manage Headers

    microsoft/power-platform-skills

    Official

    Inspects and configures the security headers a Power Pages site sends to browsers — Content Security Policy, frame and clickjacking protection, cross-origin sharing, cookie behavior, and related…

    972 GitHub stars~3k tokensUpdated today
    Auto-check: notes
  • Scan Code

    microsoft/power-platform-skills

    Official

    Scans a Power Pages site project for security issues in source code and dependencies.

    972 GitHub stars~3.4k tokensUpdated today
    Auto-check: notes
  • Scan Site

    microsoft/power-platform-skills

    Official

    Runs a security scan on a deployed Power Pages site, fetches the latest scan report, and produces a plain-language summary.

    972 GitHub stars~3.2k tokensUpdated today
    Auto-check: notes
  • Setup Datamodel

    microsoft/power-platform-skills

    Official

    Creates Dataverse tables, columns, and relationships for a Power Pages site based on a data model proposal.

    972 GitHub stars~4k tokensUpdated today
    Auto-check: notes
  • Add Server Logic

    microsoft/power-platform-skills

    Official

    Creates, edits, and manages Power Pages Server Logic files — server-side JavaScript that runs securely on the Power Pages runtime.

    972 GitHub stars~18k tokensUpdated today
    Auto-check: notes

Questions about Add Sharepoint

What does Add Sharepoint do?

A skill your agent uses when the user wants to read or write SharePoint lists, manage documents in a SharePoint document library, or create a new SharePoint list from a Power Apps mobile app. Add Sharepoint is an agent skill from microsoft/power-platform-skills, published by the product's own GitHub organization. Use when the user wants to read or write SharePoint lists, manage documents in a SharePoint document library, or create a new SharePoint list from a Power Apps mobile app.

When should I use Add Sharepoint?

Add Sharepoint fits situations like: the user wants to read; write SharePoint lists; manage documents in a SharePoint document library; create a new SharePoint list from a Power Apps mobile app.

How do I install Add Sharepoint in Claude Code?

Run `npx skills add microsoft/power-platform-skills --skill add-sharepoint -a claude-code`. Or copy the skill folder (plugins/mobile-apps/skills/add-sharepoint in microsoft/power-platform-skills) into .claude/skills/add-sharepoint in your project. Claude Code loads it when a task matches its description.

How do I install Add Sharepoint in Codex?

Run `npx skills add microsoft/power-platform-skills --skill add-sharepoint -a codex`. Or copy the skill folder (plugins/mobile-apps/skills/add-sharepoint in microsoft/power-platform-skills) into .agents/skills/add-sharepoint in your project. Codex loads it when a task matches its description.

Can I use Add Sharepoint in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add microsoft/power-platform-skills --skill add-sharepoint -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-sharepoint, .gemini/skills/add-sharepoint, .github/skills/add-sharepoint and .opencode/skills/add-sharepoint in your project.

What does Add Sharepoint need to run?

Going by SKILL.md and its folder, Add Sharepoint needs the command-line tools its instructions call (npm, npx, az and node). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Read, Edit, Write, Grep, Glob, Bash, AskUserQuestion, EnterPlanMode, ExitPlanMode.

Does Add Sharepoint access the network?

SKILL.md names 3 domains. In commands or code: contoso.sharepoint.com, make.powerapps.com and graph.microsoft.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Add Sharepoint safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Add Sharepoint use?

Add Sharepoint is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Add Sharepoint use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.8k tokens, read only when the agent opens those files.

What are the alternatives to Add Sharepoint?

Skills that share tags, products or a category with Add Sharepoint: Colleague Distillation (ZhixiangLuo/10xProductivity, 478 stars), Msgraph (codemie-ai/codemie-code, 294 stars), aai-cli Microsoft 365 (aai-labs/agent-barn, 109 stars) and Workiq (microsoft/work-iq, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add Sharepoint?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/power-platform-skills, which has 972 GitHub stars. The repository holds 87 skills in this directory. The repository was last updated on October 7, 2026.

Source: microsoft/power-platform-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.