agent-file-specs

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

1|Updated Feb 22, 2026

Search Tags:#specifications #ai #customization #skills #agents #prompts #instructions

Ready to run

npx skills add https://github.com/pfchrono/SimpleUnitFrames --skill agent-file-specs-pfchrono

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: agent-file-specs
Source: https://github.com/pfchrono/SimpleUnitFrames/tree/main/.agents/skills/agent-file-specs
Command: npx skills add https://github.com/pfchrono/SimpleUnitFrames --skill agent-file-specs-pfchrono

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides definitive specifications for AI customization files, ensuring correct formatting, required fields, and supported attributes for agents, skills, prompts, and instructions.

Core Features & Use Cases

Authoritative Specs: Get the exact file formats, locations, and settings for AI customization.
Provider Support: Understand how files map across GitHub Copilot, Claude Code, Codex, and OpenCode.
Use Case: You need to create a new custom agent for VS Code. This Skill will tell you the exact .agent.md file structure, required YAML frontmatter, and where to place the file for VS Code to recognize it.

Quick Start

Reference the SKILL.md file specification to understand its structure and required fields.

Frequently Asked Questions about agent-file-specs

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

FAQPage Schema

What are the required fields and file locations for AI coding assistant customization files?▼

AI coding assistant customization files require specific YAML frontmatter fields, file locations, and VS Code settings depending on the provider. This specification details the exact structure for agents, skills, prompts, and instructions to ensure proper recognition.

How do I create a custom agent for VS Code Copilot?▼

To create a custom agent for VS Code, you need to structure an `.agent.md` file with the correct YAML frontmatter and place it in the designated file location. This specification provides the exact file structure required for VS Code recognition.

Does this AI customization specification support multiple providers like Claude Code and Codex?▼

Yes, the specification supports multiple providers including GitHub Copilot, Claude Code, Codex, and OpenCode. It details how customization files map across these different AI coding assistants.

What is the correct file structure for an Agent Skills open standard file?▼

The Agent Skills open standard defines a specific file structure with required YAML frontmatter attributes. This Skill provides the definitive specification for formatting these files correctly.

Why is my custom AI agent file not being recognized by VS Code?▼

Custom AI agent files may not be recognized if they lack required YAML fields or are placed in incorrect file locations. This specification outlines the exact supported attributes and VS Code settings needed for proper recognition.

Can I use the same customization file format for prompts and instructions across different AI assistants?▼

Customization file formats for prompts and instructions vary by provider. This specification explains how files map across GitHub Copilot, Claude Code, Codex, and OpenCode to ensure correct formatting.