Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 3, 2026

Both .claude/skills/ and .codex/skills/ were pointing to a shared skills/a11y-audit/SKILL.md, adding unnecessary verbosity to the codebase root and preventing LLM-specific optimization.

Changes

Claude skill (.claude/skills/a11y-audit/SKILL.md)

  • Simple frontmatter per Claude agent skills spec: name + description
  • Full accessibility audit checklist inline

Codex skill (.codex/skills/a11y-audit/SKILL.md)

  • Extended frontmatter per agentskills.io spec: adds version: 1.0.0 and tags
  • Same audit content, enables platform-specific enhancement later
---
name: codex-a11y-audit
description: Use when reviewing UI diffs...
version: 1.0.0
tags:
  - accessibility
  - ui
  - testing
---

Updated references

  • .cursorrules/accessibility.md now points exclusively to .codex/skills/a11y-audit/SKILL.md (since Cursor IDE uses Codex)

Removed

  • skills/a11y-audit/SKILL.md and empty parent directory
Original prompt

This section details on the original issue you should resolve

<issue_title>Setup Claude and Codex skills</issue_title>
<issue_description>### Priority

None

Feature Description

Create dedicated SKILL.md for Claude and Codex. Currently, they're both pointing to a shared SKILL.md, but that is making the codebase root unnecessarily verbose. It also doesn't let us leverage the nuances between Claude and Codex.

Save Codex skill in .codex/skills

When creating the Codex accessibility skill, follow:

When creating Claude skill, save in .claude/skills/ and follow:

Remove the shared skill in favor of the custom skills for each LLM

Use Case

This'll save devs time by making the LLM responses higher quality

Additional Context

<agent_instructions>Follow best practices. Take your time to read the provided docs and make the best implementation</agent_instructions>

Comments on the Issue (you are @copilot in this section)


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI changed the title [WIP] Setup dedicated skills for Claude and Codex Create dedicated Claude and Codex skills, remove shared skill Jan 3, 2026
Copilot AI requested a review from tyler-dane January 3, 2026 21:54
@tyler-dane tyler-dane marked this pull request as ready for review January 3, 2026 21:55
Copilot AI review requested due to automatic review settings January 3, 2026 21:55
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR successfully migrates from a shared accessibility audit skill to dedicated Claude and Codex skills, reducing verbosity in the codebase root and enabling LLM-specific optimizations in the future.

Key changes:

  • Created separate skill files for Claude (.claude/skills/a11y-audit/SKILL.md) and Codex (.codex/skills/a11y-audit/SKILL.md) with platform-specific frontmatter
  • Updated all references in .cursorrules/accessibility.md to point to the new LLM-specific skill locations
  • Removed the shared skills/a11y-audit/SKILL.md file

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File Description
.claude/skills/a11y-audit/SKILL.md Created Claude-specific skill with minimal frontmatter (name + description) per Claude agent skills spec
.codex/skills/a11y-audit/SKILL.md Created Codex-specific skill with extended frontmatter including version and tags per agentskills.io spec
.cursorrules/accessibility.md Updated all four references to point to both new skill locations
skills/a11y-audit/SKILL.md Removed shared skill file

@tyler-dane tyler-dane changed the title Create dedicated Claude and Codex skills, remove shared skill chore: create dedicated Claude and Codex skills, remove shared skill Jan 3, 2026
Copy link
Contributor

@tyler-dane tyler-dane left a comment

Choose a reason for hiding this comment

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

@tyler-dane tyler-dane merged commit e27eb1e into main Jan 3, 2026
5 checks passed
@tyler-dane tyler-dane deleted the copilot/setup-claude-and-codex-skills branch January 3, 2026 23:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Setup Claude and Codex skills

2 participants