Skills

SharePoint Skill walkthrough: cross-report analysis across three weeks

A live demo of a SharePoint AI Skill running cross-report analysis across three weeks of project site reports. Plus updating metadata through chat and improving library readability with no JSON.

Daniel AndersonDaniel Anderson9 min read

A Skill on a project's SharePoint site can read three weekly reports, identify recurring themes, summarise subcontractor performance, list outstanding actions, and produce an overall assessment. The user types one sentence. The Skill does the rest. The same site demo also shows updating list metadata through chat and applying conditional formatting with no JSON.

Three capabilities in nine minutes of video, all built on the same Skill pattern. This is the worked example for teams who want to see Skills run end to end on real content.

What changes when AI works your way, not the other way

Most teams hit the same wall with Copilot in SharePoint in the first few weeks. The AI is capable but generic. Ask for a status summary and you get a status summary, but it has the wrong shape, missing sections, or includes things the team does not need.

The fix is Skills. A Skill captures the shape of work the team wants every time. The cross-report analysis demo shows this exactly: same input, same shape of output, every run, regardless of who runs it.

If you want the full explainer on what Skills are and how to build them, the SharePoint AI Skills deep-dive covers anatomy, authoring, and the comparison to Copilot Studio agents. This article is the worked walkthrough.

The cross-report analysis Skill

The Skill lives at /Agent Assets/Skills/cross-report-analysis/SKILL.md on a project's SharePoint site. It defines the structure for combining multiple weekly site reports into one cross-week summary.

The five output sections defined in the SKILL.md:

  1. Work completed by the weeks. What got done in each week of the analysis.
  2. Issue log recurring themes. Issues that appeared in more than one week, with the pattern across weeks.
  3. Subcontractor performance notes. Observations about each subcontractor across the time range.
  4. Outstanding actions. Items still open at the end of the time range, with how long they have been open.
  5. Summary assessment. Overall narrative on the project's health across the weeks.

In the demo, the user opens chat and says: "I want cross-report analysis over three weeks, weeks five, six, and seven."

AI in SharePoint loads the cross-report-analysis Skill because the request matches the trigger conditions defined in the SKILL.md's When to use section. The user does not have to invoke the Skill by name; AI in SharePoint figures it out.

The Skill then:

The output reaches the user in under a minute. Same shape every time.

Updating list metadata through chat

The same demo includes a second pattern that uses AI in SharePoint directly, not via a Skill: updating metadata on list items through natural language.

The user types: "I know that week four has been submitted. Can you please update the week four site report status to be submitted?"

AI in SharePoint:

No list settings UI, no manual edit. The user describes the change; AI in SharePoint makes the change. Existing SharePoint permissions on the list and item apply, so the user can only make changes they would have been authorised to make manually.

This is not technically a Skill (no SKILL.md file required) — it is in-built AI in SharePoint behaviour for working with list items conversationally.

Enhancing library readability without JSON

The third pattern in the demo shows AI in SharePoint applying view formatting without anyone writing JSON.

The user asks: "Can you make this list look a little bit prettier? For our choice columns, let's look at adding some pills with different colours."

AI in SharePoint:

In SharePoint terms, this is the equivalent of writing JSON in the column or view formatting screens. Manually it takes 15-30 minutes per column and most users never get past the documentation. Through chat, it takes one sentence.

The same pattern works for:

This is not the same as a Skill. It is a built-in capability of AI in SharePoint when working with lists. But it pairs naturally with Skills, because once you have a Skill that produces a list, you can make the list readable in one further chat.

How the three patterns combine

The demo shows three separate AI in SharePoint behaviours: invoking a Skill, updating metadata, and applying formatting. Each one stands alone. The combination is what makes the team's day-to-day work change.

A project manager opens chat on the site Friday afternoon. Three actions take three sentences.

Sentence one: "Run the cross-report analysis Skill across weeks 5, 6, and 7." The Skill runs, the cross-week summary appears.

Sentence two: "Update the week four report status to submitted." The list item updates.

Sentence three: "Apply pill formatting to the status column with green for submitted and amber for in-progress." The view updates.

Three sentences, three minutes of work, three jobs done. Previously: an hour of summary writing, a manual list edit, and a half-day's worth of JSON formatting that nobody on the team had time to do.

What makes the Skill work

Three things from the SKILL.md file pattern that show up in the demo.

Clear trigger conditions. The When to use section names the trigger phrases ("cross-report analysis", "across weeks", "summary across reports"). When a user request matches these, AI in SharePoint auto-loads the Skill.

Defined output structure. The five sections of the cross-week summary are named explicitly in the SKILL.md. AI in SharePoint cannot drift to a different structure because the structure is in the file.

Rules per section. The Skill defines what counts as a "recurring theme" (an issue appearing in two or more of the weeks in scope) and what counts as an "outstanding action" (open more than 14 days). These rules apply consistently every run.

The anatomy of a SKILL.md file in detail is in the Skills deep-dive. The cross-report analysis Skill is one specific shape; the same anatomy works for contract review, status reports, audits, and most other team workflows.

What to do this week

Three actions if you want to ship a Skill like this on one of your team's sites.

  1. Make sure Copilot in SharePoint is enabled on the site. The admin guide for the opt-out rollout covers the PowerShell at the admin guide article.

  2. Activate the Agent Assets feature on the site if you have not already. Site settings, Site collection features, find Agent Assets, activate.

  3. Write the SHAREPOINT.md context file first, then write the Skill. The Skill works much better when AI in SharePoint already knows the site's library map, naming conventions, and rules. The template gets you there fast. Detail on the file is in the SharePoint.md article.

Once the context file is in place, pick the one workflow your team runs most repeatedly that has a consistent output shape. That is your first Skill. Open Copilot in SharePoint chat, describe the Skill in natural language, let AI in SharePoint generate the SKILL.md file, iterate over the first three runs.

If you want to build three Skills in your tenant in a single day with the SharePoint.md context file already in place and an adoption plan written for your team, the Copilot in SharePoint Immersive is the workshop format. We work in your real tenant with your real content, ship three Skills, and write the playbook before we close out the day.

Get the SharePoint.md template

The site context file pattern. Drops into /Agent Assets/SHAREPOINT.md. Loads automatically into every chat on your site. Free.

Frequently asked questions

The questions readers ask most

What is cross-report analysis in SharePoint AI Skills?

A Skill that reads multiple reports on a site and produces a single consolidated analysis. In the demo, the Skill reads weeks 5, 6, and 7 of a project's site reports and produces a cross-week summary covering work completed, recurring issues, subcontractor performance, outstanding actions, and an overall assessment. The output structure is defined in the SKILL.md file so every run produces the same shape.

How does AI in SharePoint know which Skill to load?

When the user types a request, AI in SharePoint reads the When to use sections of every Skill on the site. The most relevant Skill loads automatically. In the cross-report demo, the user types 'I want a cross-report analysis across weeks 5, 6, and 7'; AI in SharePoint loads the cross-report-analysis Skill because that phrase matches the Skill's trigger condition.

Can a Skill update metadata on items in a list?

Yes. AI in SharePoint can update SharePoint list items and library metadata through chat. The demo shows the user asking 'can you please update the week four site report status to be submitted', and AI in SharePoint locates the item, checks the schema, and applies the update. Existing SharePoint permissions on the list and item apply throughout.

Do I need to write JSON to improve library readability?

No. AI in SharePoint can apply view formatting through natural-language chat. Ask for icons, conditional formatting, alternate row highlighting, status badges, or email highlighting and AI in SharePoint applies the right formatting without you writing JSON. This is much faster than building the JSON manually in column or view formatting screens.

Where are Skills stored on a SharePoint site?

In the Agent Assets library at /Agent Assets/Skills/<skill-name>/SKILL.md. Activating the Agent Assets site collection feature creates the library; each Skill lives in its own subfolder with a SKILL.md file. The file is plain Markdown and can be edited directly in SharePoint or through chat.

How long does building a Skill like this take?

The cross-report analysis Skill in the demo took about an hour to write the first version, then maybe another 30 minutes to iterate across the first few runs. Most of the time is on the output structure (deciding what sections the cross-week summary should always contain). The Markdown itself is short — typically 40 to 80 lines per Skill.

Can the Skill work on any number of reports?

Yes within reason. The cross-report analysis Skill can run across 2 to 10 weekly reports cleanly. Beyond that, the input gets long and quality varies. For longer time ranges, split into two analyses or summarise the older reports first then feed the summaries into the cross-report Skill.

Daniel Anderson

Daniel Anderson

Microsoft MVP · 20 years on M365

Independent. Australian-based. 8,000+ newsletter subscribers at danielanderson.io. Building Copilot in SharePoint Skills in client tenants since the Knowledge Agent preview in September 2025.

Connect on LinkedIn →