skills.rest
pfchrono
pfchronoCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/pfchrono/SimpleUnitFrames --skill agent-file-specs-pfchrono
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
xDinkyxxDinkyx

agent-file-specs

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

Community
Basic
luebkenluebken

validate-md

Validate Markdown YAML frontmatter against JSON Schema definitions.

Community
Intermediate
erclxerclx
2

create-snippet

Create markdown-based AI prompt snippets for Claude Code projects.

Community
Basic
madebywildmadebywild
12

harness-settings

Centralize provider-specific harness settings across Claude Code, OpenAI Codex CLI, and GitHub Copilot.

Official
Intermediate