create-custom-skill

To create a VS Code Agent Skill, generate a directory in the .github/skills folder with a matching SKILL.md file containing valid YAML frontmatter for name, description, and body content. The skill requires correct directory naming and companion-file validation to ensure proper Copilot discovery.

A Copilot skill SKILL.md file requires YAML frontmatter with matching fields, a valid directory name, and companion-file validation. It must include structured sections for the skill name, description, and body format to pass audit checks for reusable workflow packaging.

Validate an existing VS Code Agent Skill by running the bundled audit script against the .github/skills folder. This checks for directory-name mismatches, missing sections, and frontmatter issues to ensure custom assistant capabilities meet discovery metadata requirements.

Yes, you can review and maintain reusable Copilot workflows by auditing skill content in the .github/skills folder. The validation script checks frontmatter fields and directory naming, helping decide when to extend an existing skill instead of creating a new one.

Extend an existing VS Code Agent Skill instead of creating a new one when the reusable workflow packaging already covers similar custom assistant capabilities. The skill maintenance process helps keep workflows lean by evaluating frontmatter and structure to avoid duplicate skill authoring.

Copilot skill discovery validation fails when the YAML frontmatter fields do not match the directory name or companion files. The bundled audit script detects these mismatches in the .github/skills folder to ensure correct structure and metadata for agent skill registration.