Answer: Each skill is a named subdirectory containing a SKILL.md file, and a SKILL.md file is a markdown document with optional YAML frontmatter whose fields are name and description, with the markdown body containing the instructions injected into the session context when the skill is loaded. Status: Confirmed Entry: tool/github-copilot/features/skill-directory-structure Revision: 3 Digest: sha256:e9c3906b86d5b962 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:28:17Z Last changed: 2026-11-19T13:02:15Z (SKILL.md format: — → A SKILL.md file is a markdown document with optional YAML frontmatter) Last verified: 2026-11-20T13:08:39Z Next check: 2026-11-21T13:08:39Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of directory structure | skills/ ├── code-review/ │ └── SKILL.md └── documentation/ └── SKILL.md | [1] | 2026-11-20 skillDirectories option | ./skills | [1] | 2026-11-20 discovery behavior | The CLI discovers all SKILL.md files in immediate subdirectories. | [1] | 2026-11-20 SKILL.md format | A SKILL.md file is a markdown document with optional YAML frontmatter | [1] | 2026-11-20 frontmatter field: name | name | [1] | 2026-11-20 frontmatter field: description | description | [1] | 2026-11-20 markdown body | The markdown body contains the instructions that are injected into the session context when the skill is loaded. | [1] | 2026-11-20 Sources: [1] GitHub. "Custom skills - GitHub Docs". https://docs.github.com/en/copilot/how-tos/copilot-sdk/features/skills Role: primary. Accessed: 2026-11-20T13:08:39Z Quote: "Each skill is a named subdirectory containing a SKILL.md file: skills/ ├── code-review/ │ └── SKILL.md └── documentation/ └── SKILL.md" (Supports: directory structure) Quote: "The skillDirectories option points to the parent directory (e.g., ./skills )." (Supports: skillDirectories option) Quote: "The CLI discovers all SKILL.md files in immediate subdirectories." (Supports: discovery behavior) Quote: "A SKILL.md file is a markdown document with optional YAML frontmatter" (Supports: SKILL.md format) Quote: "name : The skill's identifier (used with disabledSkills to selectively disable it). If omitted, the directory name is used." (Supports: frontmatter field: name) Quote: "description : A short description of what the skill does." (Supports: frontmatter field: description) Quote: "The markdown body contains the instructions that are injected into the session context when the skill is loaded." (Supports: markdown body) Snapshot SHA-256: 819e7dbae4b01f7e6e10621611c8401e285e4d58763e5b4760dbd5a315b6429e (captured 2026-11-18T13:03:46Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-18T13:03:48Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T13:08:39Z. No independent second source is configured for this entry Last successful check: 2026-11-20T13:08:39Z Last attempt: 2026-11-20T13:08:39Z Notes and limitations: Extracted automatically from a single official source (section "Skill directory structure"). Related: https://latestn.com/tool/github-copilot/features/skills-vs-custom-instructions What is the difference between GitHub Copilot agent skills and custom instructions? https://latestn.com/tool/github-copilot/features/spaces-supported-surfaces Where can I use GitHub Copilot Spaces? https://latestn.com/tool/github-copilot/features/split-large-methods How do I use GitHub Copilot to split up large methods? https://latestn.com/tool/github-copilot/features/share-plugin-marketplace How do I share a GitHub Copilot plugin marketplace with others? https://latestn.com/tool/github-copilot/features/share-session How do I share a GitHub Copilot CLI session with someone else? https://latestn.com/tool/github-copilot/features/simplify-inheritance-hierarchy-prompt How do I use GitHub Copilot to simplify a complex inheritance hierarchy? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-19T13:02:15Z | changed | SKILL.md format: — → A SKILL.md file is a markdown document with optional YAML frontmatter | [1] 2026-11-19T13:02:15Z | changed | discovery behavior: — → The CLI discovers all SKILL.md files in immediate subdirectories. | [1] 2026-11-19T13:02:15Z | changed | skillDirectories option: The skillDirectories option points to the parent directory (e.g., ./skills ). → ./skills | [1] 2026-11-19T13:02:15Z | changed | frontmatter field: description: description : A short description of what the skill does. → description | [1] 2026-11-19T13:02:15Z | changed | frontmatter field: name: name : The skill's identifier (used with disabledSkills to selectively disable it). If omitted, the directory name is used. → name | [1] 2026-11-19T13:02:15Z | changed | file format: A SKILL.md file is a markdown document with optional YAML frontmatter → — | [1] 2026-11-17T13:26:41Z | changed | file format: — → A SKILL.md file is a markdown document with optional YAML frontmatter | [1] 2026-11-17T13:26:41Z | changed | SKILL.md format: A SKILL.md file is a markdown document with optional YAML frontmatter → — | [1] 2026-11-13T03:28:17Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/github-copilot/features/skill-directory-structure/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/github-copilot/features/skill-directory-structure POST: https://latestn.com/dispute/tool/github-copilot/features/skill-directory-structure with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/github-copilot/features/skill-directory-structure?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). What is the SKILL.md format and directory structure for GitHub Copilot custom skills? Revision 3, last verified 2026-11-20T13:08:39Z. https://latestn.com/tool/github-copilot/features/skill-directory-structure (accessed 2026-11-21T09:50:49Z). @misc{LatestN_tool_github_copilot_features_skill_directory_structure_r3, title = {What is the SKILL.md format and directory structure for GitHub Copilot custom skills?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/github-copilot/features/skill-directory-structure}}, note = {Revision 3; digest sha256:e9c3906b86d5b962; last verified 2026-11-20T13:08:39Z; accessed 2026-11-21T09:50:49Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/github-copilot/features/skill-directory-structure