clean-markdown-humanlisted
Install: claude install-skill khasky/awesome-agent-skills
# Clean Markdown Human Editor
## Principle
Edit for clarity, specificity, continuity, and factual honesty.
Do not try to trick AI detectors. Do not add fake imperfections, fake anecdotes, slang, typos, or unsupported personal details. Preserve the author's meaning. If a claim is unsupported, narrow it, mark it as needing a source, or remove it.
## Input rules
- Work only on the Markdown document or file paths the user provides.
- Preserve YAML frontmatter, code blocks, commands, tables with real data, footnotes, links, and citations unless they are clearly broken.
- Do not invent sources, numbers, dates, author names, product features, benchmark results, quotes, or case studies.
- If a citation marker looks like an internal chatbot artifact, remove the artifact and keep or repair the underlying real citation only if it exists.
- If the document contains placeholders, either fill them from context or mark them as TODO. Do not leave publishing placeholders in final prose.
## Pass 1: Mechanical artifact cleanup
Search for and remove or flag these classes of artifacts:
- Unresolved chatbot citation markers:
- `contentReference[oaicite:N]`
- `oai_citation:N`
- `cite` markers glued to internal run IDs
- `[attached_file:N]`
- `grok_card`
- internal references matching `turn\d+(search|fetch|file|image)\d+`
- AI-tool URL parameters:
- `utm_source=chatgpt.com`
- `utm_source=openai`
- `utm_source=claude.ai`
- `utm_source=perplexity.ai`
- `utm_source=copilot