What happens if the AI encounters an ambiguous TODO or vague instruction?

The skill has a strict 'Never Fabricate' rule. It will use the AskUserQuestion tool to present you with options or ask for clarification rather than guessing your intent.

What types of files can the Refine skill handle?

It is optimized for Markdown documents, project plans, source code (JS, TS, Python, Go, etc.), and configuration files like YAML, JSON, and TOML.

Can I control the intensity of the refinement?

Yes, you can use triggers like 'make concise' for aggressive content removal or 'minimal changes' for a conservative approach that only fixes clear errors.

Does this skill change my file's structure or layout?

No, it follows an 'in-place enhancement' design principle, meaning it keeps your format, structure, and voice intact while focusing on fixing content and logic errors.

What is the purpose of the Codex Cross-Validation phase?

This phase uses a secondary check to identify issues that Claude might have missed, providing an extra layer of quality assurance for critical documents and code.

Content Refiner

Name: Content Refiner
Author: fiatkongen

byfiatkongen

0•

Productivity & Workflow

Polishes and fixes inconsistencies in text artifacts, code, and project plans using a multi-phase review and user validation process.

The Refine skill is a specialized utility for Claude Code designed to iteratively improve text-based artifacts while preserving the author's original voice and structure. It employs a rigorous five-phase workflow that includes content-type detection, automated self-correction loops, cross-validation with Codex, and interactive user resolution for ambiguous items. By strictly adhering to a 'no fabrication' policy, it ensures that TODOs and vague instructions are clarified through direct user input rather than AI assumptions, making it ideal for maintaining high-quality documentation, clean codebases, and precise project plans.

Key Features

01In-place enhancement that preserves original formatting and authorial voice

02Multi-phase iterative review process with up to 5 self-correction loops

03Context-aware refinement modes including aggressive trimming and conservative fixing

04Codex cross-validation to catch subtle issues missed during initial passes

05Interactive ambiguity resolution using the AskUserQuestion tool for TODOs and vague text

060 GitHub stars

Use Cases

01Cleaning up configuration files and environment templates while fixing syntax inconsistencies

02Polishing project plans and task lists to ensure clarity and actionable success criteria

03Reviewing and refining technical documentation or code comments for better conciseness and accuracy

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fiatkongen/saurun-marketplace refine

For use in Claude.ai and ChatGPT

Download Skill