| name | prompt-converter |
| description | Convert between Claude Code command markdown files (*.md) and GitHub Copilot prompt files (*.prompt.md). Use when porting custom prompts or CLI commands between ecosystems. |
Prompt Converter
This skill automates the bidirectional conversion between Claude Code .md command files and Copilot .prompt.md files, ensuring metadata and instructions are correctly mapped.
Environment Detection
Before executing any operations, the skill defines the skills_source path:
import os
skills_source = os.path.expanduser('~/.copilot/skills') if os.name == 'nt' else os.path.expanduser('~/.copilot/skills')
Workflow
- Analyze Source: Read the source file (Claude
.md or Copilot .prompt.md) to extract metadata (name, description, agent, tools) and instruction content.
- Map Metadata:
- Claude to Copilot: Convert frontmatter keys, ensuring
name, description, and agent (default: 'agent') are present.
- Copilot to Claude: Convert frontmatter to Claude's expected format (often simpler description/tools).
- Transform Content:
- Adjust template variables (e.g.,
\$ARGUMENTS in Copilot).
- Ensure markdown structures are preserved.
- Execute Conversion: Use the provided script to perform the transformation.
python {skills_source}/prompt-converter/scripts/convert_prompt.py --src "my-command.md" --to copilot
- Verify: Confirm the new file exists in the target directory (e.g.,
prompts/ for Copilot).
Principles
- Metadata Integrity: Preserve as much context as possible during mapping.
- Target Specifics: Use
${input:...} for Copilot parameters and $ARGUMENTS for CLI inputs where appropriate.
- Idempotency: Converting back and forth should result in minimal structural drift.
Usage
Convert Claude to Copilot
python scripts/convert_prompt.py --src path/to/claude.md --to copilot -o ./prompts
Convert Copilot to Claude
python scripts/convert_prompt.py --src path/to/copilot.prompt.md --to claude -o ./claude-commands
Resources
scripts/
convert_prompt.py: Core logic for conversion.
templates/
copilot.prompt.md.template: Boilerplate for Copilot prompts.claude.md.template: Boilerplate for Claude commands.
