Skip to content

Conversation

@pedrosousa
Copy link
Contributor

@pedrosousa pedrosousa commented Dec 22, 2025

Summary

Addresses PCX-20187.
Agent Skills seem to have better cross-tool support than rules thanks to Agent Skills open format.

Creating this PR as a first proposal.
As outlined in PCX-20187, some drift between different rules/agents/skills files for different AI tools is acceptable as we make improvements and updates.

Status of features by tool (supported + used in this repo) being added in this PR:

Tool Commands/prompts/workflows Rules Agent Skills? Agents? Plugins?
Claude Code Custom slash commands Rules - not used Agent Skills Subagents - not used Plugins - not used
Cursor Commands Rules Skills - not used; nightly release only ? ?
GitHub Copilot in VS Code Prompts Custom instructions - not used Agent Skills 1 Custom agents - not used Tools - not used
OpenCode Commands Rules - not used; single AGENTS.md file Plugins - not used; via plugin Agents Plugins - not used
Windsurf Workflows Rules openskills repo - not used; via external tool Agents.md - not used; single AGENTS.md file ?

Documentation checklist

Footnotes

  1. Claude Code config style for Agent Skills is supported out of the box as a legacy config location.

Same prompts as in OpenCode commands
Agent Skills seem to be more portable than Copilot instructions.
@github-actions
Copy link
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
* @cloudflare/pcx-technical-writing
/.github/ @cloudflare/pcx-content-engineering, @cloudflare/content-engineering, @kodster28

@github-actions
Copy link
Contributor

Copy link
Collaborator

@elithrar elithrar left a comment

Choose a reason for hiding this comment

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

given we are trying to focus on fewer tools, I am worried this PR just creates a ton of drift + maintenance problems (which means quality issues).

The result of this PR is a ton of duplicate prompts & config - I don’t think we should be merging this.

@caley-b
Copy link
Contributor

caley-b commented Dec 22, 2025

@elithrar I appreciate you sharing your feedback. We can definitely scope this PR to focus more on our external contributors because we don't want to shift internal tooling standards. We want to accommodate our external contributors, who are likely using different tools than us. By including these files, we hope to streamline the content contribution process for the community. Re: drift, we are down to update them when we hear feedback and review/approve PRs from contributors who suggest valid improvements.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants