What it does

The Skill Polisher is a specialized developer tool designed to transform raw SKILL.md files into high-conversion marketplace listings. It optimizes your documentation for ClawHub's visual layout while ensuring the underlying LLM instructions remain functionally intact.

Why use this skill

Standard documentation is often too dense for quick browsing. This skill restructures content using visual anchors, optimized code blocks, and concise paragraphs. Unlike a generic AI rewrite, it follows a strict "Content Preservation" protocol: any technical implementation details or platform-specific notes removed from the main readme are automatically migrated to a dedicated reference directory. It guarantees that aesthetics never come at the cost of execution.

How it works

• Visual Optimization: Applies formatting rules like emoji anchors and boxed lists for better readability.
• Technical Audit: Performs a safety check to ensure security notes and trigger phrases weren't lost.
• Reference Migration: Moves long-form setup guides and API notes to /references to keep the storefront clean.
• Approval Workflow: Generates a diff-style audit report before overwriting any files.