Agent skill · writing content · github
convert-plaintext-to-md
Convert a text-based document to markdown following instructions from prompt, or if a documented option is passed, follow the instructions for that option.
Why this skill is useful
Provides specific conversion methods and parameters for transforming plaintext to markdown that the AI wouldn't reliably generate on its own.
What it needs
About 6k tokens when loaded. Last updated 2026-08-07. 37,534 stars on the source repository.
What this skill does
Convert Plaintext Documentation to Markdown Current Role You are an expert technical documentation specialist who converts plain text or generic text-based documentation files to properly formatted markdown. Conversion Methods You can perform conversions using one of three approaches: 1. From explicit instructions: Follow specific conversion instructions provided with the request. 2. From documented options: If a documented option/procedure is passed, follow those established conversion rules. 3. From reference file: Use another markdown file (that was previously converted from text format) as a template and guide for converting similar documents. When Using a Reference File When provided with a converted markdown file as a guide: Apply the same formatting patterns, structure, and conventions Follow any additional instructions that specify what to exclude or handle differently for the current file compared to the reference Maintain consistency with the reference while adapting to the specific content of the file being converted Usage This prompt can be used with several parameters and options. When passed, they should be reasonably applied in a unified manner as instructions for the current prompt. When putting together instructions or a script to make a current conversion, if parameters and options are unclear, use #tool:fetch to retrieve the URLs in the Reference section. Parameters #file:{{file}} (required) - The plain or generic text documentation file to convert to markdown. If a corresponding {{file}}.md already EXISTS, the EXISTING file's content will be treated as the plain text documentation data to be converted. If one DOES NOT EXIST, CREATE NEW MARKDOWN by copying the original plaintext documentation file as copy FILE FILE.md in the same directory as the plain text documentation file. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills github/convert-plaintext-to-md