Skip to content

Centralize AI Agent Skills & Implement AGENT.md for discovery #2812

@MoshiMoshiMochi

Description

@MoshiMoshiMochi

Please confirm that you have searched existing issues in the repo

Yes, I have searched the existing issues

Any related issues?

No response

What is the area that this feature belongs to?

No response

Is your feature request related to a problem? Please describe.

Current, various AI agents (, like OpenCode, GitHub Copilot etc) utilize different paths to locate agent skills, e.g.
GitHub CoPilot -> .github/skills/<skill-name>
OpenCode -> .opencode/skills/<skill-name>
etc

This lack of standardization could lead to

  1. Redundancy of duplicate skill definitions across different directories.
  2. Compatibility Issues caused by inconsistent lookup logic by different providers.

Describe the solution you'd like

  1. Centralize all agent skills in a common directory, .github/skills/<your-skill-name>: Doing so would provide better standardization across different AI providers.

  2. Add an AGENT.md file in the root directory: This file will act as the entry point for any AI agent interacting with the repository.

    • Its role would be to explicitly map the repository's purpose and instruct agents to look in .github/skills/ directory for the skills available for use.
    • For agents with different preferred paths (e.g. OpenCode), the AGENT.md file will serve as the redirect mechanism to point them towards the centralized .github path.

Describe alternatives you've considered

No response

Additional context

No response

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions