Visually edit the YAML frontmatter of AI artifacts.
This project contains a minimal Visual Studio Code extension that:
- discovers Copilot/Agent Customizations assets in the workspace
- displays a Copilot Assets sidebar tree with Agents, Skills, Instructions, Prompts, MCP Servers, and Plugins
- lets you create and edit
*.agent.mdfiles through a visual form - shows collapsible, live validation and advice in the agent form (including YAML errors, unknown properties, and GitHub cloud's 30,000-character instruction limit)
- shows separate approximate token counts for YAML frontmatter and Markdown, plus their total, in agent, prompt, and skill forms; each section uses UTF-8 bytes / 4 (rounded up), not a model-specific bill or total conversation cost
- lets you create and edit
SKILL.mdfiles through a visual form - lets you create and edit
*.prompt.mdfiles through a visual form - supports the officially documented properties for agent frontmatter:
namedescriptionargument-hinttoolsagentsmodeluser-invocabledisable-model-invocationinfer(deprecated)targetmcp-servershandoffshooks(preview)metadata
- preserves extra properties through an advanced YAML block
The model field is edited through a selector. The default list can be customized
in VS Code settings with aiFrontmatterStudio.modelOptions, for example:
{
"aiFrontmatterStudio.modelOptions": [
"GPT-5 (copilot)",
"Claude Sonnet 4.5 (copilot)"
]
}npm test
npm run lint- Install the dependencies from the integrated terminal:
npm install-
Press
F5, or open Run and Debug and select Run Extension. VS Code will open an Extension Development Host window with the extension loaded. -
In the development window, create a
.github/agents/test.agent.mdfile with the following content:
---
name: Test Agent
description: A test agent for AI Frontmatter Studio
tools:
- read
- search
---
You are a test agent.-
Open the Copilot Assets view in the activity bar. The file should appear under Agents.
-
Click the agent to open the visual editor, modify a field, and click Save. Verify that the Markdown file was updated.
To debug the extension, set breakpoints in src/extension.js and reload the Extension Development Host window with Ctrl+R.
The extension does not require a build step. npm install is required because the parser uses the yaml package.
- Repository: https://github.com/marrubio/ai-frontmatter-studio
- VS Code extension documentation: https://code.visualstudio.com/api
- Publishing VS Code extensions: https://code.visualstudio.com/api/working-with-extensions/publishing-extension
- GitHub Copilot custom agents: https://docs.github.com/en/copilot/reference/custom-agents-configuration
- VS Code custom agents: https://code.visualstudio.com/docs/agent-customization/custom-agents
- GitHub Copilot agent skills: https://docs.github.com/en/copilot/concepts/agents/about-agent-skills
- VS Code prompt files: https://code.visualstudio.com/docs/agent-customization/prompt-files