Skip to content

Migrate skills to .agent/skills - #8585

Merged
joshblack merged 1 commit into
mainfrom
copilot/migrate-skills-to-canonical-folder
Oct 23, 2026
Merged

joshblack merged 1 commit into
mainfrom
copilot/migrate-skills-to-canonical-folder

Conversation

Copilot AI commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

Move repository skills from .github/skills to the canonical .agent/skills directory, preserving skill contents and relative links.

Changelog

New

None.

Changed

  • References: Update contributor instructions and the feature-flag cleanup workflow; synchronize the compiled prompt hash.
  • Tooling: Preserve Markdown lint exclusions for relocated skills.

Removed

  • .github/skills; all 15 skills now reside in .agent/skills.

Rollout strategy

  • None

Testing & Reviewing

Generated workflow paths for gh-aw inline-skill artifacts remain unchanged; they are separate from repository skill locations.

Co-authored-by: joshblack <3901764+joshblack@users.noreply.github.com>
@changeset-bot

changeset-bot Bot commented Oct 20, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: ef86554

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

@joshblack joshblack added the skip changeset This change does not need a changelog label Oct 20, 2026 — with Copilot SWE Agent
Copilot AI requested a review from joshblack October 20, 2026 17:20
@joshblack
joshblack marked this pull request as ready for review October 20, 2026 18:44
@joshblack
joshblack requested a review from a team as a code owner October 20, 2026 18:44
Copilot AI balanced review requested due to automatic review settings October 20, 2026 18:44
@joshblack joshblack added the integration-tests: skipped manually Changes in this PR do not require an integration test label Oct 20, 2026
@joshblack
joshblack requested a review from tay1orjones October 20, 2026 18:44
@joshblack
joshblack enabled auto-merge October 20, 2026 18:44
@github-actions
github-actions Bot temporarily deployed to storybook-preview-8585 October 20, 2026 18:52 Inactive

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

The singular .agent/skills directory is not a default Copilot discovery path, so the migration loses automatic skill discovery.

No open issues 🎉

What changed in this PR

Relocates Primer React’s 15 repository skills to .agent/skills and updates supporting tooling without changing package runtime behavior.

Changes:

  • Move skills and their reference documents.
  • Update contributor instructions, workflow references, and the compiled prompt hash.
  • Preserve Markdown lint exclusions for relocated files.
File Description
package.json Excludes .agent from Markdown linting.
.github/​workflows/​cleanup-feature-flags.md Updates skill paths.
.github/​workflows/​cleanup-feature-flags.lock.yml Synchronizes the body hash.
.github/​instructions/​changesets.instructions.md Updates changesets skill path.
.github/​copilot-instructions.md Updates referenced skill paths.
.agent/​skills/​turborepo/​SKILL.md Relocates Turborepo guidance.
.agent/​skills/​turborepo/​references/​watch/​RULE.md Relocates watch guidance.
.agent/​skills/​turborepo/​references/​filtering/​RULE.md Relocates filtering reference.
.agent/​skills/​turborepo/​references/​filtering/​patterns.md Relocates filtering examples.
.agent/​skills/​turborepo/​references/​environment/​RULE.md Relocates environment reference.
.agent/​skills/​turborepo/​references/​environment/​modes.md Relocates environment modes.
.agent/​skills/​turborepo/​references/​environment/​gotchas.md Relocates environment troubleshooting.
.agent/​skills/​turborepo/​references/​configuration/​tasks.md Relocates task configuration.
.agent/​skills/​turborepo/​references/​configuration/​RULE.md Relocates configuration overview.
.agent/​skills/​turborepo/​references/​configuration/​gotchas.md Relocates configuration troubleshooting.
.agent/​skills/​turborepo/​references/​configuration/​global-options.md Relocates global options.
.agent/​skills/​turborepo/​references/​cli/​RULE.md Relocates CLI guidance.
.agent/​skills/​turborepo/​references/​cli/​commands.md Relocates command reference.
.agent/​skills/​turborepo/​references/​ci/​vercel.md Relocates Vercel guidance.
.agent/​skills/​turborepo/​references/​ci/​RULE.md Relocates CI principles.
.agent/​skills/​turborepo/​references/​ci/​patterns.md Relocates CI patterns.
.agent/​skills/​turborepo/​references/​ci/​github-actions.md Relocates GitHub Actions examples.
.agent/​skills/​turborepo/​references/​caching/​RULE.md Relocates caching reference.
.agent/​skills/​turborepo/​references/​caching/​remote-cache.md Relocates remote-cache guidance.
.agent/​skills/​turborepo/​references/​caching/​gotchas.md Relocates cache troubleshooting.
.agent/​skills/​turborepo/​references/​boundaries/​RULE.md Relocates package-boundary guidance.
.agent/​skills/​turborepo/​references/​best-practices/​structure.md Relocates repository structure guidance.
.agent/​skills/​turborepo/​references/​best-practices/​RULE.md Relocates monorepo practices.
.agent/​skills/​turborepo/​references/​best-practices/​packages.md Relocates package creation guidance.
.agent/​skills/​turborepo/​references/​best-practices/​dependencies.md Relocates dependency guidance.
.agent/​skills/​turborepo/​command/​turborepo.md Relocates orchestration command instructions.
.agent/​skills/​style-guide/​SKILL.md Relocates style-guide entry point.
.agent/​skills/​style-guide/​docs/​component-prop-types.md Relocates prop-type guidance.
.agent/​skills/​style-guide/​docs/​component-prop-naming.md Relocates prop-naming guidance.
.agent/​skills/​storybook/​SKILL.md Relocates Storybook guidance.
.agent/​skills/​slots/​SKILL.md Relocates slots guidance.
.agent/​skills/​modular-ds-utilities/​SKILL.md Relocates utility-hook guidance.
.agent/​skills/​modular-ds-spectrum-model/​SKILL.md Relocates abstraction-model guidance.
.agent/​skills/​modular-ds-presentational-components/​SKILL.md Relocates presentational-component guidance.
.agent/​skills/​modular-ds-config-components/​SKILL.md Relocates config-component guidance.
.agent/​skills/​modular-ds-base-components/​SKILL.md Relocates base-component guidance.
.agent/​skills/​modular-ds-accessibility-contract/​SKILL.md Relocates accessibility ownership guidance.
.agent/​skills/​feature-flags/​SKILL.md Relocates feature-flag guidance.
.agent/​skills/​deprecations/​SKILL.md Relocates deprecation guidance.
.agent/​skills/​create-adr-migrator/​SKILL.md Relocates migration-planning guidance.
.agent/​skills/​changesets/​SKILL.md Relocates changeset guidance.
.agent/​skills/​agentic-workflows/​SKILL.md Relocates workflow routing guidance.

Review effort: Balanced

@joshblack
joshblack removed their request for review October 21, 2026 20:32
@primer
primer Bot disabled auto-merge October 23, 2026 15:49
@primer
primer Bot disabled auto-merge October 23, 2026 15:49
@joshblack
joshblack added this pull request to the merge queue Oct 23, 2026
Merged via the queue into main with commit 2a3fcc6 Oct 23, 2026
71 of 72 checks passed
@joshblack
joshblack deleted the copilot/migrate-skills-to-canonical-folder branch October 23, 2026 16:04

This branch was successfully deployed

1 active and 1 inactive deployments
storybook-preview-8585 — ef86554f Deployed Oct 20, 2026 by github-actions[bot]
github-pages — ef86554f Deployed Oct 20, 2026 by Copilot via deploy-preview #33804
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

integration-tests: skipped manually Changes in this PR do not require an integration test skip changeset This change does not need a changelog

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants