Agent skill

internal-doc-polisher

Transform raw or transcript-like text into a polished Markdown document for internal sharing. Use when the user provides a text file (any mix of zh_tw, zh_cn, or en) and wants sentence repair, structured headings, concise paragraphs, a 3–7 bullet summary, and an Action Items section when tasks are mentioned.

Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/blue119/yp-skills/tree/main/internal-doc-polisher

SKILL.md

Internal Doc Polisher

Overview

Turn unstructured text into a clean Markdown document with repaired sentences, clear sections, and an executive summary. Preserve meaning, keep language consistent with the source, and output a .md file.

Workflow

1) Intake

  • Ask for the input file path if not provided.
  • Accept any text file containing zh_tw, zh_cn, or en (mixed language is fine).
  • Ask for an output path if the user specifies one; otherwise default to <input_basename>.polished.md in the same directory.

2) Repair And Clean

  • Fix fragments, grammar, and punctuation without changing meaning.
  • Remove obvious speech artifacts (stutters, repeated fillers) when they do not change intent.
  • Keep proper nouns, numbers, and domain terms intact.
  • Normalize spacing rules for the dominant language:
    • zh: no extra spaces between Chinese characters; keep English/number tokens spaced.
    • en: standard English spacing and punctuation.

3) Restructure

  • Create clear headings (##, ###) that match the content flow.
  • Group related content into concise paragraphs.
  • Convert list-like text into bullets.
  • Keep the document in the same language as the source unless the user requests translation.

4) Add Summary

  • Add a summary section at the beginning with 3–7 bullets.
  • Cover key points, outcomes, risks, and action items.
  • Keep bullets short and specific.

5) Action Items

  • If tasks or next steps are mentioned, add an ## Action Items section.
  • Convert tasks into bullet points; keep owners/dates if present.

6) Output

  • Write the final result to the requested .md file.
  • Confirm the output path in the response.

Output Template

Use this structure, adjusting headings to fit the content:

markdown
- Summary bullet 1
- Summary bullet 2
- Summary bullet 3

## Section Title
Concise paragraph.

### Subsection Title
- Bullet
- Bullet

## Action Items
- Task 1
- Task 2

Expand your agent's capabilities with these related and highly-rated skills.

blue119/yp-skills

subtitle-to-document

Convert subtitle files (WebVTT .vtt and SubRip .srt) into clean, readable text documents with multi-language support (English, Traditional Chinese, Simplified Chinese). Auto-detects format and language, removes timestamps and formatting, merges captions into natural paragraphs, strips annotations, and fixes spacing appropriately for each language. Use when the user provides a subtitle file or asks to convert captions to text.

0 0
Explore
blue119/yp-skills

pdf

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

0 0
Explore
mattpocock/skills

edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

111,310 9,758
Explore
mattpocock/skills

handoff

Compact the current conversation into a handoff document for another agent to pick up.

111,310 9,758
Explore
mattpocock/skills

obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

111,310 9,758
Explore
mattpocock/skills

setup-pre-commit

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results