jburlison/metaprompts/agent-file-specs

Claude Code and agent skill by jburlison/metaprompts

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Contains the complete specifications for AI coding assistant customization files including agents, skills, prompts, and instructions. Works with GitHub Copilot, Claude Code, Codex, OpenCode, and other providers. Use this skill when you need to reference the correct file format, required fields, supported attributes, file locations, or VS Code settings for any customization file. Follows the Agent Skills open standard (agentskills.io).

Install

npx vskill@latest install jburlison/metaprompts/agent-file-specs

SKILL.md

AI Coding Assistant Customization File Specifications

This skill provides the authoritative, up-to-date specifications for all AI coding assistant customization file types. Each file type has its own dedicated reference document with complete attribute tables, validation rules, examples, and best practices.

Standard: These specs align with the Agent Skills open standard

How to Use This Skill

  1. Read the Quick Reference below to identify the file type you need.
  2. Follow the link to the dedicated reference document for full details.
  3. Use the File Locations reference when you

need to know where files go for a specific provider.

  1. Use the Settings reference for VS Code

configuration.

Important: Detailed specifications live in the references/ folder —
not in this file. This keeps the main skill file lightweight for efficient
context loading per the

Quick Reference

TypeExtensionPurposeReference
Agent.agent.md / .mdCustom AI personas with specialized behaviors, tool restrictions, and handoff workflowsAGENTS.md
SkillSKILL.md (directory-based)Reusable, portable capabilities with scripts and resources — follows the Agent Skills open standardSKILLS.md
Prompt.prompt.mdReusable prompt templates invoked as slash commandsPROMPTS.md
Instruction.instructions.mdContextual guidance applied automatically by file type or descriptionINSTRUCTIONS.md
File Locations—Provider folder mapping, directory structure, naming conventionsFILE-LOCATIONS.md
VS Code Settings—Settings that control customization file discovery and behaviorSETTINGS.md

Provider Support

These specifications work across multiple AI coding assistant providers. Each provider uses its own base folder but the file formats are consistent:

ProviderBase Folder
GitHub Copilot.github/
Claude Code.claude/
Codex.codex/
OpenCode.config/opencode/

See FILE-LOCATIONS.md for the complete directory structure and provider-specific details.

File Type Selection Guide

Use this decision tree to choose the right file type:

  • "I want coding standards applied everywhere" → Use always-on instructions

(.github/copilot-instructions.md or AGENTS.md). See INSTRUCTIONS.md.

  • "I want different rules for different file types" → Use file-based

instructions (.instructions.md with applyTo patterns). See INSTRUCTIONS.md.

  • "I have a reusable task I run repeatedly" → Use a prompt file

(.prompt.md) invoked as a slash command. See PROMPTS.md.

  • "I need a multi-step workflow with scripts and resources" → Use an Agent

Skill (directory with SKILL.md). Portable across tools. See SKILLS.md.

  • "I need a specialized AI persona with tool restrictions" → Use a custom

agent (.agent.md). Supports handoffs for multi-step workflows. See AGENTS.md.

Authoritative Sources

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
56
Repository forks
5
7-day trend score
20

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 18 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/jburlison/metaprompts/agent-file-specs/badge)](https://verified-skill.com/skills/jburlison/metaprompts/agent-file-specs)

Something wrong with this skill or its page? Tell us.