Skip to content
cccskills
FreePublished on GitHub

markitdown-converter

Convert files to Markdown using Microsoft's MarkItDown library

The English summary is being prepared. Showing the original description.

Works withTelegram
See how to install

Files included (10)

  • SKILL.md3.3 KB
  • commands/markitdown-converter.md120 B
  • hooks/post-execute.cjs137 B
  • hooks/pre-execute.cjs244 B
  • references/research-requirements.md229 B
  • rules/markitdown-converter.md260 B
  • schemas/input.schema.json287 B
  • schemas/output.schema.json284 B
  • scripts/main.cjs426 B
  • templates/implementation-template.md229 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

MarkItDown Converter Skill

Convert files (PDF, DOCX, XLSX, PPTX, HTML, CSV, images, audio) to Markdown using Microsoft's MarkItDown library.

Usage

Skill({ skill: 'markitdown-converter' });
// Then call the converter via Bash:
// bash: python .claude/tools/cli/markitdown-convert.py <input_file> [output_file]

Supported File Types

FormatExtensions
Documents.pdf, .docx, .pptx, .xlsx
Web.html, .htm
Data.csv, .json, .xml
Images.jpg, .jpeg, .png, .gif, .webp
Audio.mp3, .wav, .m4a
Archives.zip (extracts and converts contents)
Video platformsYouTube URLs

Installation

pip install 'markitdown[all]'

CLI Wrapper

The CLI wrapper is at .claude/tools/cli/markitdown-convert.py.

Convert a file to stdout

python .claude/tools/cli/markitdown-convert.py /path/to/file.pdf

Convert and save to output file

python .claude/tools/cli/markitdown-convert.py /path/to/file.pdf /path/to/output.md

Convert with explicit extension hint (for streams)

python .claude/tools/cli/markitdown-convert.py /path/to/file --ext .pdf

Exit Codes

CodeMeaning
0Success — JSON with text_content
1Conversion error
2File not found
3markitdown not installed

JSON Output Format

{
  "success": true,
  "text_content": "# Document Title\n\nContent here...",
  "char_count": 1234,
  "source_file": "report.pdf",
  "output_file": null
}

Integration with Telegram File Drop

When a user sends a file in Telegram:

// 1. Download the file to tmp
const tmpPath = `.claude/context/tmp/telegram-upload-${userId}-${Date.now()}.${ext}`;

// 2. Run markitdown converter
const result = JSON.parse(
  execSync(`python .claude/tools/cli/markitdown-convert.py "${tmpPath}"`).toString()
);

// 3. Store as agent memory
if (result.success) {
  MemoryRecord({ type: 'discovery', text: result.text_content.slice(0, 2000), area: 'user-files' });
}

Error Handling

// Check if markitdown is installed
const { status } = spawnSync('python', ['.claude/tools/cli/markitdown-convert.py', '--help']);
if (status === 3) {
  // Not installed — guide user
  sendMessage(chatId, 'File conversion requires: pip install markitdown[all]');
}

When to Use

  • User drops a file in Telegram → convert to markdown → store as memory
  • Agent needs to process uploaded documents
  • Convert research papers (PDF) to searchable markdown
  • Extract data from spreadsheets (XLSX → markdown tables)

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Ensure accessibility in UI components including semantic HTML, ARIA attributes, keyboard navigation, and WCAG 2.2 AA compliance.

The English summary is being prepared. Showing the original description.

oimiragieo/agent-studio43Updated Jul 14, 2026

Use when you want to improve response quality through meta-cognitive reasoning. Applies 15+ reasoning methods to reconsider and refine initial outputs.

The English summary is being prepared. Showing the original description.

oimiragieo/agent-studio43Updated Jul 14, 2026

N-round opposing-stance debates for trade-off analysis. Assigns pro/con roles to agents, runs structured debate rounds with quality scoring, and produces a moderator synthesis with confidence-rated recommendation. Generalizable to architecture, technology, security, and design decisions.

The English summary is being prepared. Showing the original description.

oimiragieo/agent-studio43Updated Jul 14, 2026

Force adversarial code review stance that eliminates confirmation bias — reviewer must find issues or re-analyze

The English summary is being prepared. Showing the original description.

oimiragieo/agent-studio43Updated Jul 14, 2026

Creates specialized AI agents on-demand when no existing agent matches a request. Use when the Router cannot find a suitable agent for a task. Enables self-evolution by generating persistent agents.

The English summary is being prepared. Showing the original description.

oimiragieo/agent-studio43Updated Jul 14, 2026

LLM-as-judge evaluation framework with 5-dimension rubric (accuracy, groundedness, coherence, completeness, helpfulness) for scoring AI-generated content quality with weighted composite scores and evidence citations

The English summary is being prepared. Showing the original description.

oimiragieo/agent-studio43Updated Jul 14, 2026

See all skills by oimiragieo

Report a problem with this skill