agent-converter

Converts agent definitions between Markdown and TOML formats, individually or in batches, preserving frontmatter fields and developer instructions.

2|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/Qredence/skills --skill agent-converter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-converter
Source: https://github.com/Qredence/skills/tree/main/skills/agent-converter
Command: npx skills add https://github.com/Qredence/skills --skill agent-converter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Converts agent definitions between Markdown (with YAML frontmatter) and TOML formats to support cross-ecosystem deployment.

Core Features & Use Cases

  • Converts single agent definitions from MD to TOML and vice versa.
  • Batch-converts all agents in a directory while preserving frontmatter and developer_instructions.
  • Maps frontmatter fields to the appropriate target schema and preserves instructions for downstream tasks.

Quick Start

Run the converter on an MD file to generate a TOML file, or run it on a directory to batch-convert all agents.

Frequently Asked Questions about agent-converter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert agent definitions between Markdown and TOML formats?

To convert agent definitions between Markdown and TOML, the Skill maps YAML frontmatter fields to the target schema and preserves developer instructions. You can run it on a single file or batch-convert an entire directory.

What is the best way to batch-convert Markdown agent files to TOML?

Batch-converting Markdown agent files to TOML is done by running the converter on a directory. It processes all agents within that directory while preserving frontmatter fields and developer instructions for downstream tasks.

Does converting agent configurations between MD and TOML preserve developer instructions?

Yes, converting agent configurations between MD and TOML preserves developer instructions. The converter validates and maps YAML frontmatter fields to the target schema while keeping the developer instructions intact in the output.

When do I need to convert agent definitions to TOML format?

You need to convert agent definitions to TOML format when supporting cross-ecosystem agent deployment. This conversion enables streamlined workflows across different platforms by applying a standardized target schema.

Do I need pyyaml installed to convert Markdown frontmatter to TOML?

Yes, you need pyyaml installed to convert Markdown frontmatter to TOML. The dependency is required to validate and map the YAML frontmatter fields from the Markdown files to the target schema.

Can agent-converter handle directory-level batch conversion for agent configurations?

Yes, agent-converter handles directory-level batch conversion for agent configurations. It applies cross-ecosystem agent configuration mapping to all agents within the specified directory for streamlined workflows.