agent-file-specs

Name: agent-file-specs
Author: JBurlison

70stars8forks

How to install agent-file-specs?

jburlison/metaprompts/agent-file-specs

$npx -y skills add JBurlison/MetaPrompts --skill agent-file-specs

Installs into the current project.

Summary

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, r

Files · 1

View on GitHub

SKILL.md

1	# AI Coding Assistant Customization File Specifications
2
3	This skill provides the authoritative, up-to-date specifications for all AI
4	coding assistant customization file types. Each file type has its own dedicated
5	reference document with complete attribute tables, validation rules, examples,
6	and best practices.
7
8	> Standard: These specs align with the [Agent Skills open standard](https://agentskills.io/specification)
9	> and the [VS Code Copilot customization documentation](https://code.visualstudio.com/docs/copilot/customization/overview).
10
11	## How to Use This Skill
12
13	1. Read the Quick Reference below to identify the file type you need.
14	2. Follow the link to the dedicated reference document for full details.
15	3. Use the [File Locations](references/FILE-LOCATIONS.md) reference when you
16	need to know where files go for a specific provider.
17	4. Use the [Settings](references/SETTINGS.md) reference for VS Code
18	configuration.
19
20	> Important: Detailed specifications live in the `references/` folder —
21	> not in this file. This keeps the main skill file lightweight for efficient
22	> context loading per the
23	> [progressive disclosure](https://agentskills.io/specification) model.
24
25	---
26
27	## Quick Reference
28
29	\| Type \| Extension \| Purpose \| Reference \|
30	\|------\|-----------\|---------\|-----------\|
31	\| Agent \| `.agent.md` / `.md` \| Custom AI personas with specialized behaviors, tool restrictions, and handoff workflows \| [AGENTS.md](references/AGENTS.md) \|
32	\| Skill \| `SKILL.md` (directory-based) \| Reusable, portable capabilities with scripts and resources — follows the Agent Skills open standard \| [SKILLS.md](references/SKILLS.md) \|
33	\| Prompt \| `.prompt.md` \| Reusable prompt templates invoked as slash commands \| [PROMPTS.md](references/PROMPTS.md) \|
34	\| Instruction \| `.instructions.md` \| Contextual guidance applied automatically by file type or description \| [INSTRUCTIONS.md](references/INSTRUCTIONS.md) \|
35	\| File Locations \| — \| Provider folder mapping, directory structure, naming conventions \| [FILE-LOCATIONS.md](references/FILE-LOCATIONS.md) \|
36	\| VS Code Settings \| — \| Settings that control customization file discovery and behavior \| [SETTINGS.md](references/SETTINGS.md) \|
37
38	---
39
40	## Provider Support
41
42	These specifications work across multiple AI coding assistant providers. Each
43	provider uses its own base folder but the file formats are consistent:
44
45	\| Provider \| Base Folder \|
46	\|----------\|-------------\|
47	\| GitHub Copilot \| `.github/` \|
48	\| Claude Code \| `.claude/` \|
49	\| Codex \| `.codex/` \|
50	\| OpenCode \| `.config/opencode/` \|
51
52	See [FILE-LOCATIONS.md](references/FILE-LOCATIONS.md) for the complete
53	directory structure and provider-specific details.
54
55	---
56
57	## File Type Selection Guide
58
59	Use this decision tree to choose the right file type:
60
61	- "I want coding standards applied everywhere" → Use always-on instructions
62	(`.github/copilot-instructions.md` or `AGENTS.md`).
63	See [INSTRUCTIONS.md](references/INSTRUCTIONS.md).
64
65	- "I want different rules for different file types" → Use file-based
66	instructions (`.instructions.md` with `applyTo` patterns).
67	See [INSTRUCTIONS.md](references/INSTRUCTIONS.md).
68
69	- "I have a reusable task I run repeatedly" → Use a prompt file
70	(`.prompt.md`) invoked as a slash command.
71	See [PROMPTS.md](references/PROMPTS.md).
72
73	- "I need a multi-step workflow with scripts and resources" → Use an Agent
74	Skill (directory with `SKILL.md`). Portable across tools.
75	See [SKILLS.md](references/SKILLS.md).
76
77	- "I need a specialized AI persona with tool restrictions" → Use a custom
78	agent (`.agent.md`). Supports handoffs for multi-step workflows.
79	See [AGENTS.md](references/AGENTS.md).
80
81	---
82
83	## Authoritative Sources
84
85	- [VS Code Copilot Customization Overview](https://code.visualstudio.com/docs/copilot/customization/overview)
86	- [VS Code Custom Agents](https://code.visualstudio.com/docs/copilot/customization/custom-agents)
87	- [VS Code Agent Skills](https://code.visualstudio.com/docs/copilot/customization/agent-skills)
88	- [VS Code Prompt Files](https://code.visualstudio.com/docs/copilot/customization/prompt-files)
89	- [VS Code Custom Instructions](https://code.visualstudio.com/docs/copilot/customization/custom-instructions)
90	- [Agent Skills Specification (agentskills.io)](https://agentskills.io/specification)
91	- [Awesome Copilot (community examples)](https://github.com/github/awesome-copilot)
92	- [Anthropic Reference Skills](https://github.com/anthropics/skills)

People who liked this also viewed

6 picks

Type

agent-file-specs

70stars8forks

View on GitHub

How to install agent-file-specs?

jburlison/metaprompts/agent-file-specs

$npx -y skills add JBurlison/MetaPrompts --skill agent-file-specs

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# AI Coding Assistant Customization File Specifications
2
3	This skill provides the authoritative, up-to-date specifications for all AI
4	coding assistant customization file types. Each file type has its own dedicated
5	reference document with complete attribute tables, validation rules, examples,
6	and best practices.
7
8	> Standard: These specs align with the [Agent Skills open standard](https://agentskills.io/specification)
9	> and the [VS Code Copilot customization documentation](https://code.visualstudio.com/docs/copilot/customization/overview).
10
11	## How to Use This Skill
12
13	1. Read the Quick Reference below to identify the file type you need.
14	2. Follow the link to the dedicated reference document for full details.
15	3. Use the [File Locations](references/FILE-LOCATIONS.md) reference when you
16	need to know where files go for a specific provider.
17	4. Use the [Settings](references/SETTINGS.md) reference for VS Code
18	configuration.
19
20	> Important: Detailed specifications live in the `references/` folder —
21	> not in this file. This keeps the main skill file lightweight for efficient
22	> context loading per the
23	> [progressive disclosure](https://agentskills.io/specification) model.
24
25	---
26
27	## Quick Reference
28
29	\| Type \| Extension \| Purpose \| Reference \|
30	\|------\|-----------\|---------\|-----------\|
31	\| Agent \| `.agent.md` / `.md` \| Custom AI personas with specialized behaviors, tool restrictions, and handoff workflows \| [AGENTS.md](references/AGENTS.md) \|
32	\| Skill \| `SKILL.md` (directory-based) \| Reusable, portable capabilities with scripts and resources — follows the Agent Skills open standard \| [SKILLS.md](references/SKILLS.md) \|
33	\| Prompt \| `.prompt.md` \| Reusable prompt templates invoked as slash commands \| [PROMPTS.md](references/PROMPTS.md) \|
34	\| Instruction \| `.instructions.md` \| Contextual guidance applied automatically by file type or description \| [INSTRUCTIONS.md](references/INSTRUCTIONS.md) \|
35	\| File Locations \| — \| Provider folder mapping, directory structure, naming conventions \| [FILE-LOCATIONS.md](references/FILE-LOCATIONS.md) \|
36	\| VS Code Settings \| — \| Settings that control customization file discovery and behavior \| [SETTINGS.md](references/SETTINGS.md) \|
37
38	---
39
40	## Provider Support
41
42	These specifications work across multiple AI coding assistant providers. Each
43	provider uses its own base folder but the file formats are consistent:
44
45	\| Provider \| Base Folder \|
46	\|----------\|-------------\|
47	\| GitHub Copilot \| `.github/` \|
48	\| Claude Code \| `.claude/` \|
49	\| Codex \| `.codex/` \|
50	\| OpenCode \| `.config/opencode/` \|
51
52	See [FILE-LOCATIONS.md](references/FILE-LOCATIONS.md) for the complete
53	directory structure and provider-specific details.
54
55	---
56
57	## File Type Selection Guide
58
59	Use this decision tree to choose the right file type:
60
61	- "I want coding standards applied everywhere" → Use always-on instructions
62	(`.github/copilot-instructions.md` or `AGENTS.md`).
63	See [INSTRUCTIONS.md](references/INSTRUCTIONS.md).
64
65	- "I want different rules for different file types" → Use file-based
66	instructions (`.instructions.md` with `applyTo` patterns).
67	See [INSTRUCTIONS.md](references/INSTRUCTIONS.md).
68
69	- "I have a reusable task I run repeatedly" → Use a prompt file
70	(`.prompt.md`) invoked as a slash command.
71	See [PROMPTS.md](references/PROMPTS.md).
72
73	- "I need a multi-step workflow with scripts and resources" → Use an Agent
74	Skill (directory with `SKILL.md`). Portable across tools.
75	See [SKILLS.md](references/SKILLS.md).
76
77	- "I need a specialized AI persona with tool restrictions" → Use a custom
78	agent (`.agent.md`). Supports handoffs for multi-step workflows.
79	See [AGENTS.md](references/AGENTS.md).
80
81	---
82
83	## Authoritative Sources
84
85	- [VS Code Copilot Customization Overview](https://code.visualstudio.com/docs/copilot/customization/overview)
86	- [VS Code Custom Agents](https://code.visualstudio.com/docs/copilot/customization/custom-agents)
87	- [VS Code Agent Skills](https://code.visualstudio.com/docs/copilot/customization/agent-skills)
88	- [VS Code Prompt Files](https://code.visualstudio.com/docs/copilot/customization/prompt-files)
89	- [VS Code Custom Instructions](https://code.visualstudio.com/docs/copilot/customization/custom-instructions)
90	- [Agent Skills Specification (agentskills.io)](https://agentskills.io/specification)
91	- [Awesome Copilot (community examples)](https://github.com/github/awesome-copilot)
92	- [Anthropic Reference Skills](https://github.com/anthropics/skills)

People who liked this also viewed

6 picks

Type