agent-file-specs

Document file formats and locations for AI coding assistant customization files.

39|4|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/JBurlison/WoWAddonAPIAgents --skill agent-file-specs-jburlison
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-file-specs
Source: https://github.com/JBurlison/WoWAddonAPIAgents/tree/main/.github/skills/agent-file-specs
Command: npx skills add https://github.com/JBurlison/WoWAddonAPIAgents --skill agent-file-specs-jburlison

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides clear, authoritative specifications for all AI coding assistant customization files, ensuring you use the correct formats and structures.

Core Features & Use Cases

  • Defines File Formats: Details the structure and required fields for agents, skills, prompts, and instructions.
  • Provider Mapping: Explains where to place files for different AI providers (GitHub Copilot, Claude, etc.).
  • Use Case: You're setting up a new AI agent for your team and need to know the exact YAML structure for SKILL.md and where to place your .agent.md files. This Skill provides that definitive reference.

Quick Start

Consult the SKILL.md reference to understand the required fields for a new skill.

Frequently Asked Questions about agent-file-specs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What file formats are required for AI coding assistant customization files?

AI coding assistant customization files require specific YAML structures for agents, skills, prompts, and instructions. The Agent Skills open standard defines these file formats, detailing required fields, supported attributes, and exact file locations for various providers like GitHub Copilot and Claude.

How do I structure a SKILL.md file for a new AI agent?

To structure a SKILL.md file for a new AI agent, you must follow the Agent Skills open standard specifications. This includes defining specific YAML fields, supported attributes, and required metadata to ensure the AI coding assistant correctly discovers and applies the custom skill.

Where do I place .agent.md files for GitHub Copilot and Claude?

File placement for .agent.md files depends on the specific AI provider. The specifications map exact file locations for GitHub Copilot, Claude, and other providers, alongside the necessary VS Code settings required for proper agent discovery and behavior.

Does VS Code need specific settings to discover AI agent customization files?

Yes, VS Code requires specific settings to discover AI agent customization files. The specifications detail the necessary VS Code configuration to ensure agents, skills, prompts, and instructions adhering to the Agent Skills open standard are properly recognized and behave correctly.

What is the Agent Skills open standard for AI customization?

The Agent Skills open standard is a specification defining the structure and required fields for AI coding assistant customization files. It establishes the authoritative YAML formats for agents, skills, prompts, and instructions to ensure correct implementation across different AI providers.

When do I need to specify supported attributes in AI prompt files?

You need to specify supported attributes in AI prompt files when defining custom instructions or behaviors for coding assistants. The specifications detail these required fields and attributes to ensure your prompts integrate correctly with the target provider's discovery mechanisms.