skill-polisher
Transform raw skill documentation into high-conversion, readable marketplace listings without losing LLM context.
skill install https://www.promptspace.in/skills/skill-polisherWhat 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.
Use cases
- Refactor dense documentation into scannable marketplace listings
- Migrate technical setup guides to reference files automatically
- Audit skill descriptions to ensure trigger phrases are preserved
- Apply professional visual formatting with emoji anchors and boxed lists
Example
Prompt
Output
Polished SKILL.md ready: - Converted platform notes to references/ios-setup.md - Added ⚡ and 📊 visual anchors - Shortened 5 dense paragraphs Audit Report: [SAFE] Trigger phrases preserved [MOVE] Credential setup moved to references [NOTE] Security warnings moved to /references/security.md