CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-sharepoint

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.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary operational skill body: concrete executable commands at every step, explicit branches and validation feedback loops, and clean one-level-deep progressive disclosure verified against the actual bundle. The only cost is mild token overhead from repeated shell-guard boilerplate and dense approval/scope prose.

DimensionReasoningScore

Conciseness

The body is dense and operational with no explanation of concepts Claude already knows, but the `cd -- '<working_dir>' || { echo "BLOCKED…"; exit 1; }` guard is repeated verbatim in roughly eight code blocks, and the invocation-scope/approval prose is heavier than needed. This fits anchor 4 (efficient with minor trimmable instances) rather than anchor 5, where every token would earn its place; it is well above anchor 3, since there is no conceptual padding.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: exact CLI commands (`$PA connection list-datasets …`, `pa app add data-source …`, `npx --no-install tsc --noEmit`), a runnable PowerShell setup, and a TypeScript sample covering the common read/create/update cases. Execution details that would bloat the file (column encoding, auth internals, list-management functions) are correctly delegated to reference files, matching anchor 5's coverage of common cases.

5 / 5

Workflow Clarity

A clearly enumerated 12-step sequence with named branches (existing vs. new lists, --remove, --refresh, --plan-only), explicit validation checkpoints (review existing lists before creating in Step 4; type-check with "Fix TypeScript errors before proceeding" in Step 11), and error-recovery feedback loops (retry once on list-datasets failure; STOP if the site list is empty after confirmation). This matches anchor 5; anchor 4 would require some of these checkpoints to be missing or implicit.

5 / 5

Progressive Disclosure

A clear overview workflow with a well-signaled References section at the top, each with a one-line purpose tag ("Column encoding, choice fields, lookups, API patterns (CRITICAL)"). All three cited ./references/*.md files exist in the bundle, and references are one level deep. Step 10's inline TypeScript sample is appropriately placed at overview level; this matches anchor 5's clear-overview pattern rather than anchor 4's minor organization gaps.

5 / 5

Total

19

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with an explicit trigger clause, natural keywords, and a distinctive SharePoint-plus-Power-Apps niche. The only weakness is moderate coverage of the skill's full action space and a few missing synonyms, which keeps specificity and trigger-term quality at 4 rather than 5.

DimensionReasoningScore

Specificity

Names several concrete actions — "read or write SharePoint lists", "manage documents in a SharePoint document library", "create a new SharePoint list" — but coverage has minor gaps (no mention of connecting apps to existing lists or updating list schemas). It is above anchor 3 (only 1-2 concrete actions) but short of anchor 5's comprehensive multi-action coverage.

4 / 5

Completeness

An explicit "Use when the user wants to…" clause provides concrete trigger phrases that simultaneously state what the skill does (read/write lists, manage documents, create lists). Both what and when are clearly and explicitly answered, matching the anchor 5 example pattern; anchor 4 would require the when clause to be less explicit than it is.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: "SharePoint lists", "documents", "document library", "Power Apps mobile app". A few common variations are missing (e.g., "connect to SharePoint", "add a data source"), so it matches anchor 4 rather than anchor 5's comprehensive synonym coverage, and clearly exceeds anchor 3's partial keyword set.

4 / 5

Distinctiveness Conflict Risk

A clear niche at the intersection of SharePoint Online and Power Apps mobile apps, with distinct trigger terms; minimal risk of firing for an unrelated skill. It is not anchor 4, since it does not merely reduce overlap with a closely related skill — its triggers are essentially unique.

5 / 5

Total

18

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 4 missing, 4 deeper-than-1-level, 5 suspicious

Warning

Total

13

/

16

Passed

Repository

microsoft/power-platform-skills

Path

plugins/mobile-apps/skills/add-sharepoint/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.