Fix my skill
Paste a skill that misfires and what went wrong. It runs five checks, shows each fix as before and after and gives you the corrected file.
Runs best in: an agent in Copilot Chat. It doesn't need Cowork.
- Works in:
- Copilot Cowork, Copilot Agent Builder, Copilot Studio
- Chains with:
- Run Skill check on the fixed skill before it goes back out.
- Version:
- 1.2 (October 2026)
Who it's for
Partners, managers and anyone at the firm who writes or looks after Copilot skills. It helps most when a skill someone built works some of the time and nobody is sure why.
The problem it solves
A skill that doesn't work usually fails quietly. It never loads when someone asks for the job, loads for the wrong job, skips half its steps or produces something different each time. The cause is almost always in the SKILL.md, but working out which part is to blame means knowing what to look for.
What it does
What the skill does
Paste the skill and what went wrong. It runs five checks in order: whether the description matches how people actually ask, whether instructions contradict each other, whether a step needs a decision with no rule behind it, whether it asks for things it should look up or guesses things it should ask and whether the output is specified. A vague word such as unusual is pointed at a setting the skill already has, or it asks you for the rule. It never makes one up. It also checks the frontmatter, the file size and that the firm name and sign-off sit in House style rather than the Your firm block. It adds the standard draft-only and formulas rules where a skill needs them. It shows each fix as before and after, gives you the complete corrected SKILL.md and suggests a test prompt that should have failed before and pass now.
Use cases
- A file note skill that never loads when someone asks for a file note
- A chaser skill that gives a different layout every time it runs
- A skill that says "flag anything unusual" without saying what unusual means
- Instructions that say "under 250 words" in one place and "cover every point in detail" in another
- Checking a skill a colleague wrote before you build on it
How to use it
Install it, then use it
Install House style first. It's the one file every skill reads for your firm name, sign-off, voice and format. Fill it in once and this skill's Your firm block only needs the settings for this job. Skip it and the skill asks for your firm name and sign-off once.
In an agent: add the skill file (Frontier preview)
- 1 Download the zip file from this page.
- 2 In Copilot Chat, open an agent or create one, then go to Configure > Skills > Add.
- 3 Upload the zip. Agent Builder only takes a zip, with SKILL.md at the top level inside it, which is how this download is packaged. It does not accept a SKILL.md on its own.
- 4 Save, then test it from the Try it tab.
- 5 Paste the SKILL.md, say what it is supposed to do and what it actually did, and ask it to fix the skill.
- 6 Read the diagnosis and the before and after changes, then test the corrected SKILL.md with the prompt it suggests.
In an agent: paste the instructions (no Frontier needed)
- 1 Download the zip file from this page and unzip it.
- 2 Open SKILL.md and copy everything below the second --- line.
- 3 In Copilot Chat, open an agent or create one and paste the text into its Instructions box.
- 4 Save, then test it from the Try it tab.
- 5 Paste the SKILL.md, say what it is supposed to do and what it actually did, and ask it to fix the skill.
- 6 Read the diagnosis and the before and after changes, then test the corrected SKILL.md with the prompt it suggests.
In Copilot Studio
- 1 Open your agent in the new experience, then Build > Skills > Upload a skill.
- 2 Upload the zip (recommended, so the README travels with the skill) or the SKILL.md on its own.
In Cowork (optional)
- 1 Open Customize > Skills, select the arrow next to Add, then Upload skill, and choose the zip (recommended) or the SKILL.md on its own.
- 2 Or unzip the download and put the fix-my-skill folder in your OneDrive at Documents/Cowork/skills/. Keep the folder name as it is.
- 3 Start a new Cowork conversation so it picks up the skill, then use it the same way.
The skill itself
Read the full SKILL.md
This is the whole skill. Your firm name, sign-off and voice come from House style. Change the settings under Your firm for anything specific to this job. Everything else follows them.
---
name: fix-my-skill
description: Use when a Copilot skill is not firing, fires at the wrong time, ignores part of its instructions or produces inconsistent output. Diagnoses the SKILL.md and rewrites the parts that are causing the problem.
---
# Fix my skill
A skill that does not work usually has one of five problems, and all five are visible in the SKILL.md. This skill finds which one and fixes it.
## What you need from the user
1. The SKILL.md (pasted or as a file)
2. What it is supposed to do
3. What it actually did: the prompt used and the output, or "it never loaded"
If you only have the SKILL.md, review it against the checklist below anyway and report what you would expect to go wrong.
## The five problems
Check in this order. Report every one you find, not just the first.
**1. The description does not match how people ask.**
The description is how Copilot decides whether to load the skill. If it describes what the skill is rather than when to use it, or uses words the user would never say, it will not fire. Test: write down three ways a person would actually ask for this job. Does the description contain those words? Fix: rewrite the description as "Use when [situation]. Does [what]." using the person's own words.
**2. The instructions contradict each other or the settings.**
A Your firm block that says "under 250 words" and a method step that says "cover every point in detail". A guardrail that says never send and a step that says send. Fix: find every pair of instructions that pull against each other and pick one.
**3. A step needs a decision the skill does not give rules for.**
"Flag anything unusual" with no definition of unusual. "Use the right tone" with no tone described. Copilot will guess, differently each time. Fix: for every judgement word (unusual, appropriate, relevant, important, right), point it at a rule the skill already has (a Your firm setting, the house style) if there is one. If there is not, ask the user once for all the missing rules together, each with a recommended answer. If they do not answer, add a bracketed Your firm setting marked [confirm before use]. Never write a rule or threshold you made up.
**4. It asks for things it should look up, or guesses things it should ask.**
If the input is in a file the skill can read, it should read it. If a fact is not available anywhere, it should ask once. Fix: for each input, write which it is.
**5. The output is not specified.**
If the skill says "produce a summary" and not what sections, what order, how labelled, every run looks different. Fix: write the output section as a list of parts in order, each with a one-line description.
Also check: frontmatter is valid YAML with exactly `name` and `description`; name matches the folder; file is under 20,000 characters; no client data in the skill; firm name, sign-off and general voice are not in Your firm (replace them with the standard line pointing at the `house-style` skill). If the skill handles numbers or produces client-facing text, it must carry the standard rules (formulas only, control totals shown, nothing calculated in prose; draft only, nothing sent without review). Adding these is a fix, not a feature.
## Method
1. Read the whole SKILL.md.
2. Run the five checks. For each, say: found or not found, and where.
3. Rewrite only the parts that need it. Show each change as before and after.
4. Give the complete corrected SKILL.md.
5. Suggest one test prompt that would have failed before and should pass now. If the skill has an `examples/expected.md`, use that: run the corrected skill on the example file and confirm every fail condition is clear. If it has an example but no expected.md, write a short one from what the corrected skill now produces, so the next fix has something to test against. If it has no example at all, recommend adding an examples folder with a sample input and an expected.md.
## Output
1. **Diagnosis**: the five checks with findings.
2. **Changes**: before and after for each edit.
3. **Corrected SKILL.md**: complete, in a code block.
4. **Test prompt**.
## Guardrails
- Do not change what the skill does. Fix how it does it. If you think the skill's purpose is wrong, say so separately.
- Do not add features. A skill that does not work is not fixed by doing more.
- Keep the person's wording where it works. The fix should still read like their skill. Questions
Questions about this skill
Is the skill free?
Does it send anything?
Will it change what my skill does?
What is the most common problem?
What if I only have the SKILL.md and no example of it going wrong?
Firmwide
Want your own firm's procedures built in and kept working? That's a Firmwide install.
A fixed-price install, typically six to eight weeks: Copilot made safe and useful in your Microsoft 365, an agent and a skills pack for every department, handed over with training. Then Run keeps it working.
Next step
Want this tailored to your firm?
A free 30-minute Copilot Readiness Check with James, online. You leave knowing where Copilot can and cannot see your data, the two jobs to automate first and a rough install price. Your own agents and skills, built on your data and handed over to each department.
Related skills
All skills- Agent Works for any team
Grill my brief
Before anyone builds something internal, it interviews them one question at a time until the brief is clear enough to build from.
- Job
- Running the firm
- Works in
- Copilot Cowork, Copilot Agent Builder, Copilot Studio
- Chains with
- What should we automate finds the candidates; this skill briefs them. If the brief is for a skill, Prompt to skill builds it.
Version 1.2 Download Grill my brief - Agent Works for any team
Prompt to skill
Takes the prompt someone keeps pasting into Copilot and turns it into a skill that loads itself.
- Job
- Skills and firm voice
- Works in
- Copilot Cowork, Copilot Agent Builder, Copilot Studio
- Chains with
- Takes briefs from Grill my brief. Run Skill check on the result before sharing, then Explain this skill to my team.
Version 1.2 Download Prompt to skill - Agent Works for any team
Skill check
Before a skill goes firm-wide, this runs a fixed review. Every check gets Pass, Fix or Stop, with a one-line verdict and a sign-off line at the end.
- Job
- Skills and firm voice
- Works in
- Copilot Cowork, Copilot Agent Builder, Copilot Studio
- Chains with
- Run on anything Prompt to skill or Fix my skill produces, before Explain this skill to my team.
Version 1.2 Download Skill check