Categories
AI Best Practice Business Process Content management Copilot Governance Microsoft 365 SharePoint

SharePoint Skills Files Starter Pack

Having already published an introductory article on the upcoming #SkillsFiles feature in #SharePoint (and how they will provide context for #AI to drive #governance, #process and #content management) I felt a need to provide some practical tools. Hence this starter pack.

I recently published an article on the forthcoming Skills Files in SharePoint. To recap, Skills Files are one of those features that look modest at first glance but end up reshaping how organisations work. They give us a way to encode the norms, expectations and working patterns that usually live in people’s heads as tacit knowledge but now can surface them to make them available in a digestible format to AI in SharePoint or Copilot.

In my earlier article there is a short section on getting ready for them becoming available (spring 2026). This starter pack is designed to further help organisations take those first steps and start designing their Skills Files assets and policies. It’s not especially complicated but does require thinking and experimentation. The value comes from being explicit about how you work and giving the AI a stable foundation to build on. The main headings are the scope with subheadings being the proposed .md files at each level.

Note that this is all pre-emptive. The feature isn’t released yet. In other words, I’m guessing. Hopefully it’s a good guess and enough to steer organisations on the right path.


1. Global Skills Files (Organisation‑wide)

These are the files that will apply everywhere. They set the tone and the rules that all other Skills Files build on.

naming.md

Purpose: Establish a consistent naming convention across the organisation. Naming is the first step in findability. If you don’t get this right, everything else becomes harder.

Include:

  • date formats
  • versioning rules
  • project codes
  • document type prefixes
  • examples of good and bad filenames

metadata.md

Purpose: Define the metadata that matters and how it should be applied. Metadata is the backbone of search, governance and automation. Skills Files can enforce it, but only if you define it clearly.

Include:

  • required metadata fields
  • controlled vocabularies
  • when to use each field
  • examples of correct tagging

tone.md

Purpose: Describe the organisation’s writing style. AI is good at writing. It’s even better when it knows how you write.

Include:

  • voice and tone guidelines
  • preferred terminology
  • clarity and accessibility expectations
  • examples of “our style” vs “not our style”

governance.md

Purpose: Explain the rules that apply everywhere. Governance is only useful when it’s applied consistently. Skills Files give you a way to embed it directly into the workflow.

Include:

  • retention expectations
  • sensitivity labels
  • approval patterns
  • when to escalate
  • what the AI must never do

2. Departmental Skills Files (Functional norms)

These reflect how different parts of the organisation work. They sit beneath the global rules but above local nuance. They capture the patterns that define how each function works. Without them, AI defaults to generic behaviour, and generic behaviour rarely fits.

legal/contracts.md

Include:

  • standard contract structure
  • clause ordering
  • naming rules for contract types
  • how to classify incoming documents
  • what “complete” looks like

marketing/brand-voice.md

Include:

  • brand tone
  • messaging principles
  • formatting expectations
  • examples of approved copy

hr/policies.md

Include:

  • policy structure
  • versioning rules
  • approval workflow
  • how to summarise policies for staff

operations/project-structure.md

Include:

  • standard project folder structure
  • document templates
  • reporting cadence
  • how to handle project closure

3. Local Skills Files (Library‑specific behaviour)

These are the most targeted and the most powerful. They describe what should happen in this specific place. This is where Copilot becomes genuinely useful. It stops guessing and starts behaving like someone who understands the purpose of the library.

projects/project-behaviour.md

Include:

  • what to do when a new project starts
  • how to classify documents
  • which templates to use
  • how to summarise meeting notes
  • how to extract actions

contracts/contract-filing.md

Include:

  • how to detect contract type
  • which metadata to apply
  • how to handle amendments
  • how to generate a summary

policies/policy-lifecycle.md

Include:

  • how to identify policy documents
  • how to check for outdated versions
  • how to generate a staff‑friendly summary
  • how to flag missing approvals

4. Skills File Templates (Copy‑ready)

Below are three templates you can work with.

Template A: Global Skills File

# Purpose
This Skills File defines the organisation-wide standards for [topic].
# Principles
- Keep things simple.
- Prioritise clarity over cleverness.
- Apply rules consistently.
# Rules
1. [Rule 1]
2. [Rule 2]
3. [Rule 3]
# Examples
Good:
- [Example]
Not good:
- [Example]
# Constraints
- Do not override departmental or local rules unless explicitly stated.
- Do not invent new terminology.

Template B: Departmental Skills File

# Purpose
This Skills File describes how the [Department] team structures and manages its documents.
# Structure
All documents should follow this pattern:
1. [Section]
2. [Section]
3. [Section]
# Naming
Use the following naming pattern:
[Pattern]
# Metadata
Apply:
- [Field]: [Values]
- [Field]: [Values]
# Behaviour
When a document is uploaded:
- [Action]
- [Action]
# Examples
[Provide 2–3 examples]

Template C: Local Skills File

# Purpose
This Skills File defines how Copilot should behave in the [Library Name] library.
# When a document is uploaded
- Identify the document type.
- Apply the correct metadata.
- Place it in the appropriate folder.
- Generate a summary if relevant.
# Document types
- [Type]: [Description]
- [Type]: [Description]
# Templates
Use the following templates:
- [Template name]
# Constraints
- Do not move documents outside this library.
- Do not create new folders unless instructed.

5. Managing Skills Files

A sensible starting point is to have:

  • 4–6 global Skills Files
  • 2–5 per department
  • 1–3 per library

If you end up with dozens, you’ve gone too far. The goal is clarity, not bureaucracy. You also need to think about maintenance; think of them as living documents, not static rules. I suggest Skills Files should be:

  • short
  • readable
  • versioned (SharePoint takes care of that, though you might want to have even more rigour, treating them like code)
  • owned by the business
  • reviewed quarterly
  • updated when processes change

Ensure that you have appropriate governance, which should include approvals and lifecycle management with reviews and updates. They should be tested and refined on a regular basis and link to strategy and current focus and campaigns.

It would be wise to ensure each department, and SharePoint site owner is given training when we know enough to do that.

Next steps

I suggest creating a folder in a couple of well-structured libraries; ones that have clear purpose already. Then grab the formats above, create the initial .md files based on that and try populating them. It will get easier as you go along. Once the. SharePoint feature is released you can test and tweak. And share what you learned. In fact, even better, read the short adoption article here

Simon's avatar

By Simon

Simon Hudson is an entrepreneur and health sector specialist. He formed Cloud2 in 2008 following a rich career in the international medical device industry and the IT industry. Simon’s background encompasses quality assurance, medical device development, international training, business intelligence and international marketing and health related information and technology.

Simon’s career has spanned both the UK and the international health industry, with roles that have included quality system auditing, medical device development, international training (advanced wound management) and international marketing. In 2000 he co-founded a software-based Clinical Outcomes measurement start-up in the US. Upon joining ioko in 2004 he created the Carelink division and, as General Manager, drove it to become a multi-million pound business in its own right.
In 2008, Simon founded Cloud2 in response to a need for a new way of delivering successful projects based on Microsoft SharePoint. This created the first commercial ‘Intranet in a Box’ solution and kickstarted a new industry. He exited that business in 2019, which has continued to grow as a leading provider of Power BI and analytics solutions.

In 2016, he co-founded Kinata Ltd. to enable effective Advice and Guidance in the NHS and is currently guiding the business beyond its NHS roots to address needs in Her Majesty’s Prisons and in Australasia.

In 2021, Simon founded Novia Works Ltd.

In 2021 he was invited to become Entrepreneur in Residence at the University of Hull.

In 2022 he was recognised as a Microsoft MVP.

In 2025 he founded Sustainable Ferriby CIC, a community energy not-for-profit to develop energy generation, energy & carbon reduction, and broader sustainability & NetZero projects in the West Hull villages.

Simon has had articles and editorials published in a variety of technology, knowledge management, clinical benchmarking and health journals, including being a regular contributor to PC Pro, as well as a presenter at conferences. He publishes a blog on areas of interest at noviaworks.co.uk. He is a co-facilitator of the M365 North User Group. He is a lead author and facilitator on the Maturity Model for Microsoft 365. He is the author of two patents relating to medical devices. He holds a BSc (Hons) in Physical Science and a PGCE in Physics and Chemistry from the University of Hull.

Simon is passionate about rather too many things, including science, music (he plays guitar and octave mandola), skiing, classic cars, narrowboats, the health sector, sustainability, information technology and, by no means least, his family.

Leave a comment