[joshblack]

Add a /write-skill skill for authoring skills in the project. The goal is to have this be a reference for how we would like to author skills in order to:

• Make sure skills are only called when they are actually needed
• SKILL.md files themselves stay small and call out to references, as needed
• SKILL.md files and reference files are efficient to scan and find the information the agent needs

[changeset-bot]

⚠️ No Changeset found

Latest commit: 6a5911b

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[Copilot]

🟢 Approval recommended

The focused documentation changes have no identified blocking issues, and lockfile updates match existing manifests.

No open issues 🎉

What changed in this PR

Adds /write-skill guidance for concise, task-focused agent skills with selectively loaded references.

Changes:

• Documents skill triggers, reference organization, and targeted reading.
• Adds guidance for handling user corrections and allows tracking .agents.
• Synchronizes lockfile versions with existing workspace manifests.

File	Description
package-lock.json	Synchronizes workspace versions and dependencies.
.gitignore	Removes the .agents exclusion.
.github/​copilot-instructions.md	Adds guidance for handling skill feedback.
.agents/​skills/​write-skill/​SKILL.md	Defines skill-authoring guidance and examples.

_{Review effort: Balanced}

[tay1orjones]

I'll wait on #8572 until this is is merged so I can use it there and see how it works!

[joshblack]

@copilot let's also include the following:

• include when not to use the skill
• not including reference tables, skills should be <200 LOC of prose

Source: @lukasoppermann

[Copilot]

@copilot let's also include the following:

• include when not to use the skill...

Added guidance on when not to use the skill and a limit of under 200 lines of prose, excluding reference tables. Committed as 5d92785.

[joshblack]

@copilot this should not be for this skill but instead the direction was that skills created by this skill should include in their description when not to use it.

[Copilot]

Updated the guidance so skills authored with this skill include both when to use and when not to use them in their descriptions. Committed as 6a5911b.