draft notes Field Journal
Vol. 2026 · 15 Jun 2026 · Cowork

Cowork · by Susanth Sutheesh · 25 min read

Microsoft Copilot Cowork — Complete Skills Guide

↗ every built-in Cowork skill, how plugins extend it, and the three ways to add custom skills — no-code, low-code, pro-code

On this page

🔄 Part of the Microsoft Copilot Cowork — Complete Guide series. Copilot Cowork reached general availability on 16 June 2026, with the first wave of partner plugins now live — this page tracks each release. Last verified: 17 June 2026 · GA day.

The hub for this series — Microsoft Copilot Cowork — The Complete Guide — covers what Cowork is. This spoke is the skills-and-plugins reference for power users and developers.


TL;DR

  • Cowork ships with 13 built-in skills, organised into 5 categories (Communication · Documents · Calendar · Search · Automation)
  • A skill is a reusable recipe in your OneDrive — different from a prompt, which is a one-time instruction
  • Three ways to add custom skills: OneDrive SKILL.md (no-code), Copilot Studio (low-code), Agents SDK (pro-code)
  • Microsoft maintains four official plugin pages on Microsoft Learn for full reference — and the first wave of partner plugins (Harvey, Miro, monday.com, Moody’s, and more) is live at GA
  • The fastest way to see what your tenant has: ask Cowork “What skills do you have available?” — it lists every one with a description

Skill vs prompt — the simple mental model

This is the question I get asked first. Plain English:

PromptSkill
What it isA one-time instruction you typeA reusable recipe Cowork can run again
Where it livesIn the chat, gone when the chat endsIn your OneDrive at Documents/Cowork/Skills/<name>/SKILL.md
Who can call itJust you, in that momentCowork itself — it picks the skill based on your wording
When to use itOne-off ask · novel scenario · explorationSame workflow you do every week · multi-step thing you keep re-typing · something a teammate would also benefit from
AnalogyHand-writing instructions for a colleague each timePutting a recipe card in a recipe box — the colleague reads the card and follows the steps

The key idea: a prompt tells Cowork what to do right now. A skill teaches Cowork how to do it whenever asked. Skills also compose — one skill can hand off to another, building up multi-stage workflows.


Where to find skills in the UI

Cowork keeps all of this behind a single Customize door. Three clicks to get there.

Step 1 — Open the attach menu

From the Cowork landing, click the + button to the left of the task input. A menu opens with four options. Pick the bottom one: Customize · Manage skills & plugins.

Cowork landing page with the plus button highlighted in a red box. The attach menu is open showing four options — Add work context, Upload images and files, Attach cloud files, and Customize · Manage skills and plugins (also highlighted in red with the cursor pointer hovering on it).

Step 2 — Land on the Customize page

The Customize page has two tabs at the top: Plugins and Skills. Click Skills.

Customize page header showing a back arrow labelled Cowork, the page title Customize, two pill-shaped tabs labelled Plugins and Skills with Skills highlighted in a red box, and search and Add controls on the right.

Step 3 — See what’s installed

The Skills tab is split into two sections:

  • Your skills — custom skills you’ve added (or your IT team has rolled out)
  • Built-in — pre-installed skills Cowork uses automatically

You can toggle any skill on or off here. Disabled skills won’t be picked by Cowork even if you ask for them by name.

The Skills tab inside Cowork Customize. Two section headings highlighted in red boxes — Your skills and Built-in. Three custom skills are visible in Your skills (customer-session-followup, customer-session-prep, inbox-drafts) each with a toggle on the right. A Show more link sits below. The Built-in section begins underneath with the first three pre-installed skills (PDF, Word, Excel).

The Plugins tab lives alongside Skills — same Customize door. Microsoft first-party Dynamics 365 plugins (Fabric IQ, Sales, ERP apps, Customer Service) show here as Installed and can be toggled on/off. Third-party and partner plugins (once admin-approved at the tenant level) appear here too. If your tenant hasn’t approved any plugins yet, or if you haven’t installed any from the Discover gallery below, this tab shows just the Microsoft first-party set.

Cowork Customize page, Plugins tab. Shows Installed section with four Microsoft Dynamics 365 plugins — Fabric IQ, Dynamics 365 Sales, Dynamics 365 ERP apps, and Dynamics 365 Customer Service. Each plugin has a toggle switch on the right (all shown as off). The heading reads 'Specify which plugins Cowork should reference when doing a task.'


The 13 built-in skills

Microsoft’s official Cowork documentation lists 13 built-in skills — the canonical set every tenant gets:

#SkillWhat it covers
1WordRead, create, and edit Word documents
2ExcelRead, create, and manipulate Excel spreadsheets
3PowerPointRead, create, and edit PowerPoint presentations
4PDFRead, create, and manipulate PDF documents
5EmailDraft, reply, forward, and send through Outlook
6SchedulingSchedule meetings and manage your calendar
7Calendar ManagementFull-spectrum calendar management
8MeetingsMeeting intelligence, summaries, and prep
9Daily BriefingAggregated morning brief from calendar, email, and Teams
10Enterprise SearchSearch across your organisation’s content
11CommunicationsAudience-adaptive communications
12Deep ResearchSynthesise multiple sources into a comprehensive report
13Adaptive CardsRender structured, interactive cards

You can also add up to 50 custom skills of your own — more on that below.

The Cowork task box with the inline picker open after typing a slash — a Search field and tabs (All, Skills, People, Files, Meetings, Emails, Chats, Channels, Sites), listing built-in skills PDF, Word, Excel, PowerPoint, Calendar Management, and Daily Briefing, each with a one-line description.

A faster way to reach a skill: type / in the task box and the inline picker surfaces your skills (and people, files, meetings…) on the fly — no need to open the Customize page. (Microsoft demo tenant.)

What you’ll actually see in your tenant’s Customize panel

The Customize UI surfaces the same engine, but it shows the internal skill IDs — so a few names differ from the official list (you’ll spot html, goal, debug-trajectory, and Skill Management in place of Email, Enterprise Search, Deep Research, and Adaptive Cards). Here’s the exact list as it appears in my tenant:

#SkillWhat it does (UI description)
1PDFRead, create, and manipulate PDF documents
2WordRead, create, and edit Word documents
3ExcelRead, create, and manipulate Excel spreadsheets
4PowerPointRead, create, and edit PowerPoint presentations
5htmlCreate, edit, and validate standalone single-file HTML
6Calendar ManagementFull-spectrum calendar management with purpose-aware classification, block defense, and tiered logic
7Daily BriefingAggregated morning brief from calendar, email, Teams
8MeetingsMeeting intelligence, summaries, and prep
9SchedulingCalendar scheduling and management
10CommunicationsAudience-adaptive communications
11Skill ManagementCreate, validate, and manage personal Cowork skills and instructions
12goalSet a standing goal — the agent keeps working until the condition is met or the effort limit is reached
13debug-trajectory(Manual trigger only) Renders the current session’s transcript as a self-contained HTML attachment

The Built-in skills section inside Cowork's Customize page, scrolled to show all 13 pre-installed skills in a vertical list — PDF, Word, Excel, PowerPoint, html, Calendar Management, Daily Briefing, Meetings, Scheduling, Communications, Skill Management, goal, and debug-trajectory — each with a one-line description and a toggle on the right. A Show less link is visible at the bottom confirming this is the full list.

Mapping back to the 5 Agent Academy categories:

CategoryUI skills
CommunicationCommunications (the rest sits under task-orchestration patterns Cowork handles automatically — see the Naming convention note below)
DocumentsPDF, Word, Excel, PowerPoint, html
CalendarCalendar Management, Daily Briefing, Meetings, Scheduling
SearchBuilt into Cowork’s task-planning — surfaces through Daily Briefing, Meetings, and the cross-app reach
Automationgoal (long-running standing goals), Skill Management (creating and managing skills)

📎 Same engine, two label sets. The official Learn names (top of this section) are the canonical taxonomy; the Customize panel shows the internal IDs. When you write a custom skill that calls a built-in, use the tenant ID (e.g. pdf, html); when you explain Cowork to a colleague, use the official names.


Ask Cowork what it can do — the easy way

If you’d rather not click around the Customize page, ask Cowork directly. The single best discovery prompt:

What built-in skills do you have available? List each by name with a one-line description of what it does.

The Cowork task input box showing the typed prompt 'What built-in skills do you have available? List each by name with a one-line description of what it does.' ready to be submitted, with the formatting and microphone icons on the right of the input.

Cowork responds with a grouped list — both the built-in skills it ships with AND any custom skills you’ve added, all together:

Cowork's response listing 21 skills grouped into five categories — Document Creation (work-doc, work-presentation, work-spreadsheet, docx, xlsx, pptx, pdf, html), Productivity and Calendar (daily-briefing, calendar-management, schedule-meeting, meeting-intel, meeting-recap, inbox-drafts, stakeholder-comms), Customer Sessions (customer-session-prep, customer-session-followup), Research and Analysis (deep-research, render-ui), and Skills and Configuration (skills, update-config).

Naming convention — UI labels vs skill IDs

You’ll notice the response uses names like schedule-meeting, meeting-intel, pdf, html — the lowercase, hyphenated internal skill IDs. The Customize UI shows the friendly labels (Scheduling, Meetings, PDF, html).

When you write a custom skill that references built-in skills, use the skill IDs — that’s what Cowork’s planner matches against. When you’re explaining Cowork to a colleague, use the UI labels — they’re easier to read.


How plugins extend Cowork

Built-in skills cover the M365 apps you live in. Plugins extend Cowork to systems outside M365 — your CRM, your ticketing system, your project management tool, your data warehouse.

In plain English — connector vs plugin

Two words get thrown around a lot here. The simplest way to hold them:

  • A connector is the bridge. It lets Cowork safely reach into another app — Dynamics 365, Fabric, Power BI — and pull data across (and in some cases, send updates back).
  • A plugin is the bridge plus the know-how. It packages one or more connectors with the instructions Cowork needs to actually do a job with them.

And one phrase worth knowing: if a plugin says read & write, Cowork can both look at data in that app and — where it’s configured and you approve it — make changes (like creating or updating a record), not just view it. Read means look-only.

Microsoft maintains four reference pages on Microsoft Learn:

PageWhen to read
Available plugins for Copilot CoworkBrowse the catalog before deciding to build your own
Use plugins with Copilot CoworkEnd-user guide — how to invoke a plugin in a task
Build plugins for Copilot CoworkDeveloper reference for new plugins
Manage plugins for Copilot CoworkAdmin governance, approvals, scope, audit

Plugins available at general availability

At GA (June 2026), Microsoft shipped the first wave of partner plugins, with more on the way:

  • Available now: Enosix · Harvey · LSEG · Miro · monday.com · Moody’s · Morningstar · S&P Global Energy · TeamsMaestro
  • Coming soon: Adobe · Atlassian · Box · Canva · CB Insights · Databricks · MoneyForward · Templafy
  • Also generally available: Microsoft Fabric, plus Dynamics 365 Sales, Customer Service, and ERP apps

The catalog grows over time — check Microsoft’s Copilot Cowork docs for the current list. Treat each plugin as its own governance decision (consent, connector credentials, data handling, audit) — see the admin & governance spoke.

To browse the full GA catalog, open Cowork, click Customize, switch to the Plugins tab, then scroll down to the Discover section. Microsoft’s official plugin gallery shows every available plugin with a one-line description and a lock icon indicating tenant admin approval is required before you can install it.

Cowork Discover gallery showing 11 partner plugins available at GA — AI Meeting Notes TeamsMaestro, Box, enosix arnold for Copilot Cowork, Flow Studio MCP Copilot Cowork, Harvey (legal AI assistant), LSEG Cowork, Miro Cowork, monday.com, Moody's Credit MCP, Morningstar, and S&P Global Energy. Each plugin card shows a logo, name, lock icon, and brief description. The page header reads 'Plugins help Cowork extend its capabilities by connecting to external tools, services, and bundled skills.'

What a plugin actually unlocks

The names matter less than the job each one lets Cowork finish without leaving the task. A few examples:

If you want Cowork to…A plugin like……lets it
Turn a document into a visualMirobuild a flowchart, mindmap, or framework board from your content
Spin up a project boardmonday.comcreate the board, workstreams, and owners — not just describe them
Build an on-brand deckTemplafy (coming soon)apply your real templates and brand, not a generic theme
Reach your data and BIMicrosoft Fabricpull from your data estate so the work is grounded in real numbers

The pattern: a plugin turns “Cowork can tell you about it” into “Cowork can go do it in that tool.” Each one is still a governance decision first — connect the ones your team actually needs, and treat the rest as off until reviewed.

The GA line-up, grouped by what they’re for

The first wave skews toward finance, research, and visual work. Here’s the quick “is this even relevant to us?” read. Exact capabilities — and whether a given plugin is read-only or read & write — live in Microsoft’s plugin catalog, so treat every row as a governance decision first, not a green light.

What you’re trying to reachPlugins live at GAWho’d use it
Financial, market & research dataLSEG · Moody’s · Morningstar · S&P Global EnergyFinance, research, risk, and investment teams
Legal & professional workHarveyLegal, compliance, professional services
Enterprise records (SAP)EnosixSales and service teams working off SAP data
Visual & project workMiro · monday.comMarketing, product, programme management
Meetings & schedulingTeamsMaestroAnyone living in back-to-back meetings

Generally available alongside them: Microsoft Fabric (your data estate) and Dynamics 365 Sales, Customer Service, and ERP. The coming-soon set (Adobe, Atlassian, Box, Canva, CB Insights, Databricks, MoneyForward, Templafy — full list just above) spans documents, design, dev tooling, data, and brand templates.

Whatever the source, the rule holds: a plugin is a new door into your data — open the ones a team genuinely needs, and leave the rest off until reviewed. The admin checklist for that review is in the admin & governance spoke.


Custom skills — three paths

You’re not limited to what Microsoft ships. There are three ways to add your own.

Path 1 — Custom skills via OneDrive (no-code, works today)

This is the easiest path — no admin involvement, no app installs.

Method A — Ask Cowork to create it for you (fastest):

Tell Cowork in chat: “Create a custom skill called [name] with these instructions: [your steps]” — Cowork validates the skill, writes the SKILL.md file, and syncs it to your OneDrive automatically within ~35 seconds. Ready to use immediately.

Method B — Upload the file manually to OneDrive:

  1. Open your OneDrive — navigate to Documents → Cowork → Skills (create these folders if they don’t exist)
  2. Create a subfolder for your skill (e.g., morning-briefing)
  3. Inside that subfolder, create a file called SKILL.md
  4. Use this minimal pattern:
---
name: Morning Briefing
description: >-
  Summarises my day from calendar, email, and Teams. Use when I say
  "morning briefing", "what's on today", or "what do I need to know
  this morning".
---

# Morning Briefing

## 1. Gather context first (never invent)
- Calendar — today's meetings with times and attendees
- Email — top 3 unread emails needing my response before first meeting
- Teams — any urgent messages I haven't responded to

## 2. Output
A scannable bullet list grouped by Calendar / Email / Teams,
followed by "Top 3 priorities" picked from across all three.
  1. Save it — Cowork automatically discovers all skills in this folder at the start of every conversation.

Both methods produce the same result. Method A is great for quick personal skills; Method B is useful when you want to pre-build and distribute skill files across a team.

You can create up to 50 custom skills per user. Each file must be under 1 MB.

The SKILL.md pattern that works in practice

Cowork now standardises a richer SKILL.md structure than the earlier minimal template — and it auto-scores skills against this structure (see “Cowork scores your skill” below). When you use Method A and ask Cowork to create a skill for you, the file Cowork writes follows this 8-section pattern:

SectionPurpose
YAML frontmattername:, description: (with trigger phrases), cowork: extension (category: + icon:)The skill ID, the trigger phrases Cowork’s planner matches against, and category/icon metadata for the Skills UI
OverviewOne paragraph — what this skill does and what gets produced
When to UseTrigger scenarios written as user-facing examples
When NOT to UseWhat this skill is not for, plus explicit handoff to sibling skills (“for X, use the <other-skill> skill instead”) — this is the section Cowork scores most heavily on Scope Boundaries
Quick StartA condensed numbered workflow showing the steps Cowork will run end-to-end
Core InstructionsThe full numbered Step 1 → Step N detail. Every tool call named explicitly (ListCalendarView, ListMessages, etc.). Every parameter spelled out
OutputThe exact shape of the artefact — example tables, formatting rules, file naming
GuardrailsNumbered list of explicit rules — what NOT to do, what to never invent, when to leave [confirm] placeholders. Cowork scores this section directly under Robustness

The “never invent” line is the most important habit. It tells Cowork to leave a clearly-marked placeholder (e.g. [confirm date]) rather than guessing. That single discipline is the difference between a skill that’s safe to demo and one that occasionally embarrasses you in front of a customer.


Cowork’s 5-step skill creation pipeline

When you ask Cowork to create a skill (Method A above), it runs through a deterministic 5-step pipeline rather than just writing a file blind:

Cowork's Thought process panel expanded during skill creation. Shows the planning workflow with five numbered steps — 1. Validate the name, 2. Draft and write the SKILL.md, 3. Auto-validate and score, 4. Generate quality report, 5. Show summary. Below the list, Cowork notes that the name is valid and the user is at 4 of 50 skills used.

The pipeline:

StepWhat happens
1. Validate the nameChecks the skill name is unique in your library and that you’re under the 50-skill quota
2. Draft and write the SKILL.mdGenerates the SKILL.md file following the 8-section pattern above, writes it to your OneDrive Documents/Cowork/Skills/<name>/ folder
3. Auto-validate and scoreScores the just-written skill against four quality dimensions (Trigger Clarity, Instruction Specificity, Scope Boundaries, Robustness) plus three hard gates (Publish bar MVB ≥ 70, No-fabrication check, Risk tier classification)
4. Generate quality reportProduces a standalone skill-quality-report.html file in the task output folder showing the score breakdown
5. Show summarySends a final chat summary with the trigger phrases, what the skill does, and the score

This is new behaviour — older Cowork builds wrote the SKILL.md and stopped there. The validation + scoring + report pattern means a custom skill arrives audit-ready.


Cowork scores your skill — Skill Quality Report

After writing the SKILL.md, Cowork displays a Skill Quality Report card in the chat. The score is out of 100, computed from four 25-point dimensions, with three hard gates that decide whether the skill is publishable.

Cowork's Skill Quality Report card showing a sample skill scoring 96 out of 100 with an Excellent green badge. A full-width green progress bar sits below the title. The Dimension Breakdown lists four scored dimensions — Trigger Clarity 25 of 25 with note '6 trigger phrases plus exclusion clause', Instruction Specificity 25 of 25 with note 'Numbered workflow, named tools, output format, Quick Start', Scope Boundaries 23 of 25 with note 'When NOT to Use section, delegation to sibling skills', and Robustness 23 of 25 with note '10 guardrail rules, missing-data handling'. Below the dimensions are three rows — Publish bar (MVB greater than or equal to 70) marked PASS, No-fabrication check marked PASS, and Risk tier shown as Medium (read-only, no writes). A note on the right reads Syncing to OneDrive (about 35 seconds), and the six trigger phrases that fire the skill are listed at the bottom.

The four dimensions

DimensionMaxWhat earns full marks
Trigger Clarity25Multiple trigger phrases (≈5+), distinct wording (not just synonyms), and a “Do NOT use for…” exclusion clause that delegates to sibling skills
Instruction Specificity25Numbered Core Instructions workflow, every tool call named (ListCalendarView, docx, etc.), explicit Output format with example tables, a Quick Start condensed view
Scope Boundaries25“When NOT to Use” section that explicitly delegates to sibling skills, clear in-scope vs out-of-scope boundary
Robustness25Multiple explicit guardrail rules (10 is a strong baseline), missing-data handling with [confirm] placeholders, “never invent” discipline

The three hard gates

GateWhat it means
Publish bar (MVB ≥ 70)Minimum Viable Bar — skills scoring under 70 are flagged as not-publishable; Cowork won’t promote them as ready-to-use
No-fabrication checkValidates the skill enforces “never invent” discipline — placeholders for missing facts rather than guesses
Risk tierClassified Low / Medium / High based on what the skill writes or sends. Read-only skills (only retrieves data, doesn’t post or send) get Medium; skills that send emails or post to Teams without checkpoints get High

What you see in the chat after creation

The final chat summary tells you what the skill is, the score, the trigger phrases, and attaches the standalone skill-quality-report.html file for review later.

Cowork's final chat summary after creating a skill. Headline reads 'Your friday-portfolio-digest skill is live and scored 96 out of 100 — Excellent, well above the 70 publish bar.' Lists six trigger phrases — friday portfolio digest, weekly customer touchpoint review, who do I need to stay in touch with, friday customer review, portfolio check, and who needs a touchpoint before the weekend. Below that, six numbered steps describe what the skill does — scans calendar for external attendees, checks sent items for outbound emails, checks inbox for inbound flagged messages, marks orgs with no touchpoint in 14 plus days as Stale, produces a scannable digest with Active / Awaiting Reply / Stale / Top 3 sections and saves a .docx file named friday-portfolio-digest-2026-06-15.docx, and never sends or posts anything. Closing note says the quality report is saved to files and changes will appear in OneDrive within about 35 seconds. An attached file shown is skill-quality-report.html.

💡 Use the scoring to tune your prompts. When I asked Cowork to create the friday-portfolio-digest skill above, the first generation scored 96 — the 4 lost points came from two dimensions (Scope Boundaries and Robustness) where my create-prompt could have been more explicit. If a skill scores below the Publish bar, re-issue the create-prompt with more guardrails, more sibling-skill delegation, and more specific tool names. Cowork will re-score the next version. It’s a working feedback loop.


The Skill Quality Report — the friendly HTML version

Alongside the technical Dimension Breakdown card in chat, Cowork also writes a standalone skill-quality-report.html file to the task output folder. Same data, much friendlier presentation — designed for a human reader to skim in 30 seconds.

The standalone skill-quality-report.html file opened from a Cowork task output folder. Top: a green celebration banner labelled FRIDAY-PORTFOLIO-DIGEST with the heading 'This skill is ready to share' and the message 'Everything important is in place. Nice work — you can rely on this one.' Below: a big circular score showing 96 out of 100 in a green ring, with three pill tags — Meets the bar to publish (green), Risk: medium (orange), Grounding: PASS (green). Below the score: section heading 'What's already working' with a thumbs-up emoji and four green-tick bullets — It switches on at the right time. It knows what to do. It stays in its lane. It handles surprises safely.

Friendly names — the same four dimensions, in plain English

The chat card uses technical names (Trigger Clarity, Instruction Specificity, Scope Boundaries, Robustness). The HTML report uses the friendly version. Mapping for reference:

Chat card (technical)HTML report (friendly)The plain-English question it answers
Trigger ClaritySwitches on at the right timeDoes Copilot know when to reach for this skill?
Instruction SpecificityKnows what to doAre the steps clear enough to get the same result every time?
Scope BoundariesStays in its laneDoes it avoid stepping on other skills’ jobs?
RobustnessHandles surprises safelyDoes it check before risky actions and never make things up?

The same skill-quality-report.html scrolled to the section titled 'The four things that make a skill dependable'. Four rows each with a smiling-face emoji, the dimension name, a one-line question, and a Strong label on the right with a green progress bar underneath — Switches on at the right time (Does Copilot know when to reach for this skill?), Knows what to do (Are the steps clear enough to get the same result every time?), Stays in its lane (Does it avoid stepping on other skills' jobs?), Handles surprises safely (Does it check before risky actions and never make things up?). Below the four-things section is an orange-tinted warning panel headed 'Please double-check the safety items' with a single bullet — Touches 'people-profiling' scope (WARN).

Safety warnings — scope flags you should know about

Below the four-dimension scores, the HTML report surfaces a “Please double-check the safety items” panel listing any sensitive scopes the skill touches. For the friday-portfolio-digest example above, Cowork flagged people-profiling (WARN) because the skill scans other people’s emails and meeting attendee lists to classify customers.

Common scope flags worth knowing:

Scope flagWhat it meansWhen it fires
people-profilingThe skill reads or classifies data about other identifiable peopleSkills that scan email/meeting/Teams data with attendee or sender attribution
external-data-egressThe skill writes to a system outside your tenantSkills that post to third-party APIs, public web forms, or external CRMs
mass-communicationThe skill sends to many recipients at onceSkills that draft or send broadcast emails or Teams channel posts
irreversible-actionThe skill performs actions that can’t be undoneSkills that delete files, cancel meetings, or move calendar events permanently

A WARN doesn’t block publication — it’s a reminder to double-check the skill handles the sensitive scope responsibly. The friday-portfolio-digest skill is read-only and never sends anything, so the people-profiling WARN is acceptable.

Technical details for the curious

The HTML report also has a collapsible “Technical details” section at the bottom showing the machine-readable classifications behind the friendly summary.

The same skill-quality-report.html scrolled further to two more sections. First a panel titled 'Do this next' with the message 'Nothing urgent — this skill is in great shape' and a celebration emoji. Below it a collapsible section 'Technical details (for the curious)' expanded to show three rows of metadata — Score: 96 out of 100, Publish bar: 70. Risk factors: takes actions (autonomy / blast radius). Grounding: instructs grounding / no-fabrication. Below those rows is a small table titled Dimension and Score with four rows — Switches on at the right time 25/25, Knows what to do 25/25, Stays in its lane 23/25, Handles surprises safely 23/25.

These machine-readable values are the ones to reference if you’re building an admin dashboard, a skill governance audit, or a CI check that wants to enforce a minimum publish score across a team’s shared skill library.


Worked Example #2 — building a new-account-research-brief skill

To show what the scoring looks like for a higher-risk skill, here’s a second worked example. The intent: when I’m about to engage a brand-new customer for the first time, I want Cowork to produce a “what we know about Contoso” briefing — fanning out across my email, Teams, SharePoint, calendar, and the public web simultaneously, and identifying which colleagues have already touched the account.

This skill is more ambitious than friday-portfolio-digest:

  • It uses Deep Research (touches the public web)
  • It does people-profiling at scale (matches every internal colleague who has interacted with the customer)
  • It produces a Word briefing for me to read pre-meeting

I expected the Risk tier to escalate. It did.

The create prompt

The Cowork task input box showing the typed create-prompt for a new-account-research-brief skill. The visible text reads: 'Create a custom skill called new-account-research-brief with these instructions: This skill produces a what we know about customer briefing when I'm about to engage a new account for the first time — gathers everything in my M365 plus the public web, classifies by source, and tells me who in my org has touched them already. 1. Gather context (never invent) — Email — search Inbox plus Sent Items for any past correspondence with anyone at customer (match by email domain).'

Cowork’s planning

Cowork's expanded thought-process panel for the new-account-research-brief skill creation. Shows the same 5-step pipeline as before. Notes 'Name is valid, 5 of 50 slots used' (one more than the previous skill). Plans to integrate six data sources — Email, Teams, SharePoint/OneDrive, People, Public web via Deep Research, Calendar — produce a Word briefing with specific sections, and provide clear trigger phrases.

The score — 95/100, Risk: HIGH

Cowork's Dimension Breakdown chat card for the new-account-research-brief skill. Score: 95 out of 100 with an Excellent green badge. Publish Bar shows green tick Pass (greater than or equal to 80). Faithfulness shows green tick Pass. Dimension table — Trigger Clarity 25/25 (note: 8 trigger phrases plus exclusion clauses), Instruction Specificity 25/25 (numbered workflow, named tools, output format, Quick Start), Scope Boundaries 25/25 (When NOT to Use section, delegates to 4 named skills), Robustness 20/25 (6 guardrail rules plus missing-data handling). Trigger phrases listed: research customer, new account brief for customer, what do we know about customer, first-meeting prep for customer, tell me about customer, plus 3 more. Delegates to: customer-session-prep, inbox-drafts, meeting-recap, customer-session-followup. Quality report path: output/skill-quality-report.html.

The standalone HTML quality report for the new-account-research-brief skill opened in a viewer. Top: green celebration banner labelled NEW-ACCOUNT-RESEARCH-BRIEF with the heading 'This skill is ready to share' and the standard message 'Everything important is in place.' Below: circular score showing 95 out of 100 in a green ring, three pill tags — Meets the bar to publish (green), Risk: high (red outline) and Grounding: PASS (green). Lower section 'What's already working' with four green-tick bullets.

What changed vs friday-portfolio-digest

Two skills, two scores, two risk tiers. The pattern is informative.

friday-portfolio-digestnew-account-research-brief
Score96 / 10095 / 100
Risk tierMediumHigh
Trigger Clarity25/25 (6 phrases)25/25 (8 phrases)
Instruction Specificity25/2525/25
Scope Boundaries23/25 (2 sibling skills)25/25 (4 sibling skills)
Robustness23/25 (10 guardrails)20/25 (6 guardrails)
Risk factorsTouches people-profilingTouches people-profiling + uses Deep Research (public web) + writes Word doc

What this tells you:

  • More explicit sibling delegation → higher Scope Boundaries. Naming 4 sibling skills in “When NOT to Use” got the full 25/25.
  • More guardrails matter more than I realised. 6 guardrails got 20/25; 10 got 23/25. Aim for 8-10+ explicit numbered guardrails for full marks.
  • Risk tier escalates when you add capabilities, not when you add guardrails. Even with the same care, a skill that touches the public web AND people data AND writes documents will land on High — which is fine, it’s a signal not a blocker. The publish bar still passes.

💡 The publish bar has two visible tiers. The HTML report says Publish bar: 70 (MVB — Minimum Viable Bar). The chat card for higher-risk skills like this one shows the threshold as ≥80 (the Excellent tier). A skill scoring 75 would publish (clears MVB) but wouldn’t earn the Excellent banner — useful when you want to lift quality across a shared team library.

Final chat summary

Cowork's final chat summary for the new-account-research-brief skill. Headline: 'Your new-account-research-brief skill is live and scored 95 out of 100 — Excellent.' Below: a 'What it does' paragraph explaining the skill fans out across the user's M365 (email, Teams, SharePoint, calendar) and the public web simultaneously, identifies which Microsoft colleagues have touched the account, produces a Word briefing plus a 3-bullet TL;DR in chat, and never sends anything (for the user's eyes only). Below that: a list of five trigger phrases with a customer placeholder — Research customer, New account brief for customer, What do we know about customer, First-meeting prep for customer, Tell me about customer (external company). Closing note that the full quality report is in skill-quality-report.html and the skill syncs to OneDrive within about 35 seconds. An attached file is shown: skill-quality-report.html.


Worked Example #3 — building a cowork-skill-author meta-skill (and the UI evolves)

The third example is a meta-skill — a skill that creates other skills. Its job is to take a one-line brief from me and produce a high-quality SKILL.md against the 8-section pattern, every time, with the quality scoring automatically run on each new skill it authors.

This worked example also surfaces something interesting: Cowork’s Skill Quality Report UI is evolving rapidly. The card shown here is materially different from the earlier two — Microsoft is iterating on this surface week to week. The signal value is unchanged, but the layout and labels are not yet stable. Treat this as a snapshot, not a contract.

The create prompt

The Cowork task input box showing the typed create-prompt for a cowork-skill-author meta-skill. Visible text reads: 'Create a custom skill called cowork-skill-author with these instructions: This is a meta-skill: it CREATES other Cowork skills following the standard high-quality 8-section pattern. Use when I want to bulk-author new skills against a quality bar rather than typing each one from scratch. 1. Gather context (never invent) — From my single-sentence brief, derive: skill name (lowercase-hyphenated), one-paragraph description, and the workflow I want it to follow. Check the Skill Management skill is available (Cowork's built-in skill-creation tool). This skill orchestrates it; it does not write.'

The result — 98/100 with a brand-new 3-column card

Cowork's Skill Quality Report card for the cowork-skill-author meta-skill in a new layout. Header: skill name 'cowork-skill-author' with subtitle 'Skill Quality Report' and an Excellent green badge. A three-column header panel shows Score 98 out of 100, MVB Gate PASS (floor: 80), Risk Tier High (guardrails present). Below: Dimension Breakdown — Trigger Clarity 25/25 (7 trigger phrases, exclusion clause), Instruction Specificity 25/25 (72 workflow lines, tools named, Quick Start), Scope Boundaries 23/25 (When NOT to Use section, focused scope), Robustness 25/25 (9 guardrail rules, missing-data handling, confirmation gates). Below that a new Safety Signals section with three rows — Destructive scope WARN (mentions destructive actions in context of flagging them; guardrails present), People-profiling scope WARN (mentions profiling to prohibit it; guardrails present), Faithfulness PASS (instructs grounding / no-fabrication). Below: Trigger phrases to use this skill listed — author me a skill, build me a skill that, create a skill for, spin up a skill, I need a skill that, skill-author build, skill-author batch. Final note: cowork-skill-author is live — scored 98/Excellent, MVB passed.

What’s new in this card vs the earlier ones

ElementSkills C + D (earlier card)Skill E (this card)
Header layoutSingle-row: title + score badgeThree-column — Score | MVB Gate | Risk Tier — each with its own labelled panel
Threshold label“Publish Bar: ≥80” or “Publish bar (MVB ≥ 70)”“MVB Gate: PASS · floor: 80” — terminology shifted from Publish bar to MVB Gate
Risk Tier presentationListed in the dimension areaPromoted to a top-row column with a one-line qualifier (“guardrails present”)
New Safety Signals sectionNot presentSeparate from Risk Tier — itemises specific scope flags (Destructive scope, People-profiling scope, Faithfulness) with WARN/PASS per row
Workflow-size measurementImplicitExplicit — “72 workflow lines” shown as the Instruction Specificity rationale
Context-aware classificationImplicitVisible reasoning — e.g. “mentions destructive actions in context of flagging them” recognises the skill is prohibiting destructive actions, not performing them

Cowork is context-aware, not just keyword-matching

The single most interesting thing in this card is the per-signal rationale:

Destructive scope — WARN — “mentions destructive actions in context of flagging them; guardrails present”

People-profiling scope — WARN — “mentions profiling to prohibit it; guardrails present”

Cowork’s classifier reads the intent. A skill that prohibits destructive actions isn’t penalised the same way as one that performs them — but it still surfaces the WARN so a reviewer can confirm the intent is correctly framed. That’s a thoughtful design choice and it matters for any team reviewing skills at scale.

The stubborn -2 on Scope Boundaries

All three skills lost 2 points on Scope Boundaries (got 23/25 once and 25/25 once across this set). Pattern observed:

  • The full 25/25 was earned by new-account-research-brief with explicit delegation to 4 named sibling skills (customer-session-prep, inbox-drafts, meeting-recap, customer-session-followup)
  • The 23/25 was earned by skills with fewer named sibling delegations (2-3) even with strong When NOT to Use sections

If full marks on Scope Boundaries matters for your team’s library, name at least 4 sibling skills in the When NOT to Use section.


The fourth example builds a skill that produces an external-facing artefact — a LinkedIn carousel deck about a Microsoft product topic (Copilot, Cowork, Scout, etc). The output is a .pptx that I export to PDF and upload to LinkedIn as a document carousel.

This skill behaves differently from the first three in one important way: it generates an artefact that LEAVES my tenant. That changes the scoring.

The create prompt

The Cowork landing page showing the typed create-prompt for a linkedin-carousel-microsoft skill. Visible text reads: 'Create a custom skill called linkedin-carousel-microsoft with these instructions: This skill produces a LinkedIn carousel as a PowerPoint deck (.pptx) about a Microsoft product topic — Copilot, Cowork, Scout, Microsoft 365 E7, Frontier, Agent Builder, Copilot Studio, Foundry, or related capabilities. Visual style matches my aguidetocloud.com blog's notebook aesthetic: cream paper background, ink-blue text, pen-red accents, handwritten title font, no emoji in slide bodies. Use when I want a visual multi-slide carousel for LinkedIn — not just a text post.'

The result — 91/100 with the first amber bar of the series

Cowork's Quality Report card for the linkedin-carousel-microsoft skill in yet another evolved layout. Header: skill name with subtitle 'Personal skill · writing · SlideText' and an Excellent green badge on the right. Three-column header row showing — Overall Score 91 out of 100 (MVB passed, threshold 80), Risk Tier High (Behavioural review recommended), Skill Slot 8 out of 50 (42 slots remaining). Below: Dimension Scores section with four bars — Trigger Clarity 25/25 full green bar, Instruction Specificity 22/25 nearly-full green bar, Scope Boundaries 25/25 full green bar, Robustness 19/25 amber/yellow bar (the first non-green bar in the series). Triggers section lists six numbered trigger phrases including linkedin carousel about topic, draft a linkedin carousel on topic, carousel for the new feature, linkedin visual post on topic, build a carousel about topic, share microsoft topic as a linkedin carousel. Footer notes the quality report is saved as skill-quality-report-linkedin-carousel.html and will sync to OneDrive in about 35 seconds.

Why the score dropped — Cowork explains it

The chat summary for this skill is more diagnostic than the earlier ones. Cowork explains where each point was lost AND why some of those losses are acceptable.

Cowork's final chat summary for the linkedin-carousel-microsoft skill in a diagnostic narrative format. Headline: 'linkedin-carousel-microsoft is created and live. Here's the summary.' Score 91/100 — Excellent — well above the 80 MVB publish bar. A bulleted breakdown follows — Perfect scores on Trigger Clarity and Scope Boundaries (6 trigger phrases, full delegation map to sibling skills, airtight exclusions). 22/25 Instruction Specificity (the scorer noted no explicit tool names in the description block; tools are named inside the body, which is correct for skills this complex). 19/25 Robustness (solid guardrails but a high-risk skill by nature — file generation plus external-facing content; a behavioural test run would push this higher). Below: Risk tier is High because it generates files and produces externally-visible content — the scorer recommends a real-world behavioural test before relying on it in front of customers. That just means try it once on a topic you know well and check the output. Closing line: It will sync to your OneDrive in about 35 seconds at Documents/Cowork/. Three example invocations are shown — LinkedIn carousel about Microsoft 365 Copilot pages, Build a carousel about Copilot Studio agent builder, Draft a linkedin carousel on Frontier. Attached file: skill-quality-report-linkedin-carousel.html.

What the amber bar means — Robustness has an external-facing ceiling

The first three worked examples all stayed inside the tenant — read from M365, wrote a Word doc to OneDrive, surfaced output in chat. Cowork’s scorer treats those as lower-blast-radius skills and rewards them with full Robustness if the guardrails are explicit.

This fourth skill is different. It produces a deck that I export to PDF and upload to LinkedIn — an externally-visible artefact. Even with the same care given to guardrails, the scorer drops Robustness by 5-6 points because the blast radius extends beyond the tenant.

The scorer also surfaces a new qualifier next to the Risk Tier: “Behavioural review recommended.” Plain English translation: run the skill once on a topic you know well, audit the output by hand, then trust it in front of customers.

New things in this card vs the earlier three

ElementEarlier worked examplesThis card
Skill classificationNot shownNew subtitle: Personal skill · writing · SlideText — Cowork tags every skill with Type · Category · Subtype
Header layout2-column or 3-column with MVB GateNew 3-column: Overall Score · Risk Tier · Skill Slot (slot counter promoted to its own column)
Risk Tier qualifierListed plainlyNow includes guidance text — “Behavioural review recommended” for High-risk skills
Bar coloursAll greenFirst amber bar observed — Robustness 19/25 renders amber, not green, signalling “real but not full marks”
Quality report filenameGeneric skill-quality-report.htmlSkill-specific suffix: skill-quality-report-linkedin-carousel.html
Chat summary toneCompact listDiagnostic narrative — explains why each point was lost AND when the loss is acceptable

What the 4 worked examples teach us

InsightWhere it came from
Score is reliably ≥ 90 when the create-prompt covers the 8-section pattern. All four skills landed 91-98.All 4 worked examples
Full Trigger Clarity (25/25) needs 6+ trigger phrases + an exclusion clause. Easy points if you remember.All 4
Full Scope Boundaries (25/25) needs 4+ named sibling skills in “When NOT to Use”. Two delegations gets you 23. Four gets you 25.Skills C (23/25, 2 siblings) vs D (25/25, 4 siblings)
Full Robustness (25/25) needs ~9-10 explicit numbered guardrails + confirmation gates. Fewer drops you to 20-23.Skills C (10 guardrails, 23/25) vs D (6 guardrails, 20/25) vs E (9 guardrails + confirmation gates, 25/25)
External-facing skills have an inherent Robustness ceiling. Even strong guardrails won’t push past ~19-21/25 if the artefact leaves your tenant.Skill F (file gen + external-facing → 19/25 amber bar)
Risk Tier escalates with capabilities, not with care. Adding Deep Research, people-profiling, or external delivery escalates you to High no matter how clean the guardrails are.Skills D and F
Cowork’s scorer reads intent, not just keywords. A skill that prohibits destructive actions is recognised as flagging-them-to-block, not performing-them.Skill E (Destructive scope WARN with “in context of flagging them”)
The Quality Report UI is iterating fast. I saw four materially different card layouts within an hour, plus a friendly HTML report surface that uses different language entirely. Treat any specific screenshot as a snapshot, not a contract.All 4 worked examples

Iterating an existing skill — push the score higher

A skill doesn’t have to be perfect on the first try. Cowork’s Skill Management skill can update an existing SKILL.md based on your refinement instructions — and the quality scorer re-runs automatically every time. Two patterns are worth knowing.

Pattern A — tweak that hits perfect 100

I asked Cowork to update friday-portfolio-digest (which had scored 96/100) with two changes: expand “When NOT to Use” from 2 sibling delegations to 6, and add 3 more guardrails (including confirmation gates).

The update worked — and revealed something important: Cowork’s scorer can self-correct mid-run.

The Skill Quality Report for friday-portfolio-digest version 2 after the tweak. Above the report a narrative line reads: Validation passes. Score is 98 out of 100. Trigger clarity, instruction specificity, and scope boundaries are all 25/25. Robustness is at 23/25, missing the +3 confirmation-gate credit because the scorer's pattern (confirm before) is not in the new rule text. One small re-word of rule 9 fixes it while keeping the intent identical. Below: the final report header friday-portfolio-digest Skill Quality Report. Big score 100 out of 100 with an Excellent green badge. Dimensions section with all four marked Perfect (green badge) at 25/25 — Trigger Clarity (6 trigger phrases · exclusion clause in description), Instruction Specificity (69 workflow lines · Quick Start block · named tools · output format), Scope Boundaries (When NOT to Use: 7 bullets · 6 named sibling skill delegations), Robustness (13 guardrail rules · failure handling · 2 confirmation gates · free-mail filter). Gates and Safety section: MVB gate PASS (score 100, floor 70), Faithfulness PASS — no-fabrication instructions present, Safety note: people-profiling scope WARN — expected for a contact-triage skill, Dimensions below 25: None.

What happened in that header narrative:

  1. Cowork applied the tweak I asked for
  2. Ran the scorer — got 98/100
  3. Cowork itself noticed Robustness was 23/25 because the scorer’s specific text pattern (confirm before) wasn’t matched, even though my new guardrails had the same INTENT
  4. Cowork re-worded rule 9 itself to include the matching pattern, without me asking
  5. Re-ran the scorer — landed on 100/100

That’s autonomous skill improvement. The lesson: when you tweak a skill, Cowork doesn’t just apply-and-stop — it iterates against its own scorer until it’s hit the wall.

Cowork's chat summary of the friday-portfolio-digest tweak. Headline 'Done, Susanth. Here's the summary of what changed and the final result:'. 'What was updated' section with two bullets: When NOT to Use expanded from 4 bullets to 7, each delegating to a named sibling skill — customer-session-prep, inbox-drafts, meeting-recap, meeting-intel, morning-briefing, weekly-team-update, new-account-research-brief — and a send-never reminder. Guardrails grew from 8 to 11 rules — the three additions add a 10-customer confirmation gate (surfaces count first), a single-signal noise gate (possibly noise — confirm placeholder), and a free-mail domain filter (gmail, outlook, yahoo, hotmail, icloud, proton.me). Score result table with four rows showing Before 25 / After 25 for Trigger Clarity, Before 25 / After 25 for Instruction Specificity, Before 25 / After 25 for Scope Boundaries, Before 23 / After 25 for Robustness in bold, and Total Before 96 / After 100. Closing line: No dimensions below 25. All gates pass. Changes will sync to OneDrive within about 35 seconds.

Pattern B — tweak that hits a structural ceiling

I tried the same trick on new-account-research-brief (which had scored 95/100). Asked Cowork to add 5 more guardrails — push Robustness from 20 to 25.

The skill went from 95 → 97. Not 100. Cowork explained why.

A Before/After quality score comparison card for new-account-research-brief. Subtitle 'After adding 5 new guardrails'. Two big score circles side by side with an arrow between — Before 95 Excellent (blue), After 97 Excellent (green). Dimension table with Before / After / Max columns — Trigger Clarity 25/25/25 unchanged, Instruction Specificity 25/25/25 unchanged, Scope Boundaries 25/25/25 unchanged, Robustness 20/22 with green triangle up indicator/25 (up by 2). Metadata rows — Guardrails 8 → 13 (+5 added), MVB gate ≥80 PASS, Faithfulness PASS instructs grounding / no-fabrication, Safety WARN high-risk skill (touches sensitive data); behavioral review recommended. Below: 97/100 Excellent. Up from 95. The Robustness dimension moved from 20 to 22, with 13 guardrails now in the file (up from 8). All 5 new rules are live — 1. Confirmation gate (zero internal plus zero web results trigger ask for spelling before continuing). 2. 24-month web filter (stale news excluded unless foundational fact). 3. Source preference (own site, Reuters, Bloomberg, NZ Herald, AFR first; blogs/forums last). 4. Employee privacy (name plus role plus LinkedIn URL only; no salary or personal detail). 5. Stale colleague flag (18-month threshold triggers stale — confirm still at Microsoft placeholder). Closing diagnostic: On the remaining 3 points: The scorer's Robustness rubric caps at 22/25 for the current pattern mix — it's looking for a specific combination of negative-path handling, edge-case examples, and fallback instructions beyond guardrail count. The three other dimensions are already at 25/25, and the improvements list is empty, meaning the scorer has no further actionable suggestions. 97 is effectively the ceiling the rubric can reach for this skill's structure without adding a dedicated Edge Cases or Fallback Procedures section to the SKILL.md body — which would be a larger structural change. Happy to do that if you want to chase 100.

The diagnostic at the bottom is the takeaway:

“The scorer’s Robustness rubric caps at 22/25 for the current pattern mix — it’s looking for a specific combination of negative-path handling, edge-case examples, and fallback instructions beyond guardrail count… 97 is effectively the ceiling the rubric can reach for this skill’s structure without adding a dedicated Edge Cases or Fallback Procedures section to the SKILL.md body.”

Translation: the rubric has sub-patterns inside each dimension. For Robustness to hit 25/25 on a skill like this, the scorer is looking for:

  1. ✓ Lots of explicit guardrails (we had 13)
  2. ✓ Failure handling (we had it)
  3. ✓ Confirmation gates (we had them)
  4. ✗ A dedicated ## Edge Cases H2 section (we didn’t have one)
  5. ✗ A dedicated ## Fallback Procedures H2 section (we didn’t have one)

Adding more bullets inside existing sections doesn’t satisfy points 4 and 5 — the scorer wants distinct H2 sections. Cowork offered to add them (“Happy to do that if you want to chase 100”).

The HTML Skill Quality Report for new-account-research-brief tweaked version. Green celebration banner labelled NEW-ACCOUNT-RESEARCH-BRIEF with the heading 'This skill is ready to share' and the standard message 'Everything important is in place.' Below: circular score 97 out of 100 in a green ring; three pill tags — Meets the bar to publish (green), Risk: high (red outline), Grounding: PASS (green). Below: 'What's already working' section with four green-tick bullets — It switches on at the right time. It knows what to do. It stays in its lane. It handles surprises safely.

Pattern C — structural restructure to reach 100

Per Pattern B above, new-account-research-brief capped at 97/100. The scorer wanted two NEW H2-level sections (## Edge Cases and ## Fallback Procedures) — not more bullets. I asked Cowork to add them.

This time the score hit a clean 100/100.

The HTML Skill Quality Report for new-account-research-brief after the structural restructure. Green celebration banner labelled NEW-ACCOUNT-RESEARCH-BRIEF with the heading 'This skill is ready to share' and the message 'Everything important is in place. Nice work — you can rely on this one.' Below: a big circular score showing 100 out of 100 in a thick green ring. Right of the circle the text reads 'Here's the overall health score for this skill. It clears the minimum quality bar, so it's safe to publish or share.' Three pill tags — Meets the bar to publish (green), Risk: high (red outline), Grounding: PASS (green).

Cowork's chat summary 'Done. Here's the result, Susanth:'. A Before/After dimension table follows with a Skill updated label new-account-research-brief. Rows: Trigger Clarity 25/25 → 25/25, Instruction Specificity 25/25 → 25/25, Scope Boundaries 25/25 → 25/25, Robustness 22/25 → 25/25 with a green tick mark on the After cell. Total row 97/100 → 100/100. Below the table: Grade Excellent — MVB gate passed (80 threshold, high-risk tier). What was added (appended after Guardrails, no existing content touched): hash-hash Edge Cases — 6 numbered scenarios covering subsidiary ambiguity, zero-results plus spelling suggestions, M&A detection, conflicting public facts, departed-colleague labelling, and sanctions/reputational flags with a top-of-briefing due-diligence block. hash-hash Fallback Procedures — 5 numbered procedures covering Deep Research outage, SharePoint zero-match expansion, calendar timeout, People API rate-limiting with batch retry, and DOCX skill failure with markdown fallback. The quality report is saved to skill-quality-report.html. Changes will sync to your OneDrive within about 35 seconds.

What the rubric is actually looking for

Robustness 25/25 needs ALL of these — not any one alone:

Sub-patternWhat “satisfied” looks like
Many explicit guardrails9-13 numbered rules in the Guardrails section
Failure handlingRules that name specific failure modes (“if X then Y”)
Confirmation gatesRules using the pattern “confirm before X”
Dedicated Edge Cases H2 sectionAn H2 heading + numbered list of negative-path scenarios with handling logic per case
Dedicated Fallback Procedures H2 sectionAn H2 heading + numbered list of fallback steps per service/data-source failure

Skill D had 4 of 5 with the bullet tweaks. Adding the missing 2 H2 sections produced the perfect score.

Skill D’s final structure (12 sections total)

After the restructure, the SKILL.md now has 12 H2 sections instead of 8:

  1. YAML frontmatter
  2. Overview
  3. When to Use
  4. When NOT to Use (4 sibling delegations)
  5. Quick Start
  6. Core Instructions (7 numbered steps with named tool calls)
  7. Output
  8. Formatting rules
  9. Guardrails (13 numbered rules)
  10. Edge Cases (6 negative-path scenarios with handling) ← NEW
  11. Fallback Procedures (5 service/data-source failure paths) ← NEW
  12. Templates / Output examples

This is now the canonical reference structure for any skill that needs to reach 100/100 — every section above contributes to a specific sub-pattern in the rubric.

Final scoreboard across all worked examples

SkillFirst scoreAfter bullet tweaksAfter structural restructureCeiling reason
C friday-portfolio-digest96100 (autonomous self-correction)Hit perfect via Pattern A
D new-account-research-brief9597 (rubric cap)100 (Pattern C — added 2 H2 sections)Hit perfect via Pattern C
E cowork-skill-author98Near-ceiling at create; focused scope keeps it at 98
F linkedin-carousel-microsoft91External-facing inherent ceiling (~96 reachable; not worth chasing)

Three Patterns observed — each illustrative for different skill types:

PatternWhen it appliesWorked example
A — autonomous self-correctionSkill is structurally close to 100, just needs scorer-pattern-matchingSkill C
B — bullet tweaks hit a ceilingMore guardrails / more delegations only push so farSkill D first iteration
C — structural restructureRubric needs new H2 sections, not more bulletsSkill D second iteration

💡 Practical guidance for skill authors: Use Patterns A and B first. Move to Pattern C only when the improvements list is empty AND the skill genuinely benefits from edge-case + fallback documentation (most real production skills do). Don’t add ceremonial H2 sections to chase the score on a simple skill — keep the SKILL.md proportional to the skill’s complexity.


Path 2 — Custom skills via Copilot Studio (low-code, for admins)

If you’re an IT admin or power user, Copilot Studio lets you build custom skills using Power Automate flows, API connectors, or AI-powered topics. Once published, they appear as callable actions inside Cowork.

Path 3 — Pro-code skills (for developers)

For full control, the Microsoft 365 Agents SDK lets developers build skills in .NET, JavaScript, or Python. Register them in Copilot Studio and they become available inside Cowork — just like any built-in skill.


Where to find more skills

ResourceWhat’s there
microsoft/skills on GitHub130+ pre-built skills, ready to deploy or customise
microsoft/CopilotStudioSamplesAgent and skill samples for real business scenarios
microsoft/AgentsSDK for building your own custom skills
Copilot Studio Sample GalleryOfficial curated samples from Microsoft

⚠️ Admin tip: Before adding third-party skills, review the permissions they request. Each skill accesses data on behalf of the user — so treat skill approval the same way you’d treat an app approval in Entra ID. Start with a pilot group.

📖 Add and manage skills in Copilot Studio


Other Cowork spokes

Official Microsoft references for skills + plugins

Community Cowork skill libraries (with attribution)

The Cowork developer community is publishing creative skill patterns publicly. One worth a look if you build custom skills:

  • ITSpecialist111/Copilot-Cowork-Skills — a personal research repository containing two interesting patterns:
    • skill-factory — a meta-skill that batch-creates other skill packages to a defined quality bar
    • rfp-agent-swarm — a 7-skill pipeline for RFP response work (intake → fit assessment → drafting → human gates → review → assembly), shared substrate, 4 hard human-approval gates

⚠️ Note on community content: Community repos like the one above are independent research artefacts, not Microsoft products. The author of that repo states this clearly. They can be excellent learning material but should always be validated against Microsoft Learn — Cowork before being used with real data.