rm-agent-markdown-optimizer

Convert agent-only markdown files into token-efficient imperative directives.

Updated Nov 11, 2023

Search Tags:#workflow #markdown #optimization #agents #compression #instructions #confirmation

Ready to run

npx skills add https://github.com/michaelvolz/redmuffin.Blazor.StaticWeb --skill rm-agent-markdown-optimizer

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: rm-agent-markdown-optimizer
Source: https://github.com/michaelvolz/redmuffin.Blazor.StaticWeb/tree/main/.opencode/skills/rm-agent-markdown-optimizer
Command: npx skills add https://github.com/michaelvolz/redmuffin.Blazor.StaticWeb --skill rm-agent-markdown-optimizer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents human-targeted markdown from being blindly reformatted by only accepting agent-only files and compresses verbose instructions into token-efficient, imperative guidance that AI agents can execute consistently.

Core Features & Use Cases

Extension validation: Accepts only .md or .mdc files to keep processing predictable and rejects others immediately.
Agent-only confirmation: Prompts for explicit user approval via the opencode question tool before any transformation, canceling on denial.
Preserves everything: Rewrites content while retaining every constraint, command, version, structure, workflow, pattern, boundary, and context from the original document.
Use Case: Convert a contributor's detailed instructions into the agent-optimized layout described by the workflow so automated agents consume a compact, imperative plan.

Quick Start

Ask the agent to convert the designated agent-only markdown file into compact, agent-optimized format with rm-agent-markdown-optimizer.

Frequently Asked Questions about rm-agent-markdown-optimizer

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

FAQPage Schema

How do I optimize markdown instructions for AI coding agents to reduce token usage?▼

Yes, markdown compression for AI agents preserves every constraint, command, version, path, workflow, pattern, boundary, and context from the original document. It rewrites the content into an imperative layout while ensuring no critical instructions are lost during the token-efficient conversion.

How do I convert a human-readable markdown file into an agent-optimized format?▼

Markdown optimization for AI agents requires explicit user approval before any transformation occurs. The system prompts for confirmation via the question tool and immediately cancels the process on denial, ensuring human-targeted markdown is never blindly reformatted without consent.

Can I use markdown optimization on any file format besides .md and .mdc?▼

No, markdown optimization for AI agents strictly accepts only .md or .mdc files to keep processing predictable. The system enforces extension validation and immediately rejects any other file formats before attempting to compress instructions into the agent-ready layout.

When should I compress markdown files into token-efficient directives for automated agents?▼

You should compress markdown files into token-efficient directives when you have detailed contributor instructions that automated agents need to execute consistently. This ensures AI coding agents consume a compact, imperative plan rather than struggling with verbose, human-targeted documentation.