One-click install
npx skills add https://github.com/ejoongseok/claude-settings --skill rewrite-external
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rewrite-external
Source: https://github.com/ejoongseok/claude-settings/tree/main/claude-code/skills/rewrite-external
Command: npx skills add https://github.com/ejoongseok/claude-settings --skill rewrite-external

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts internally written Markdown documents into externally readable versions that third parties can understand quickly and confidently, while preventing sensitive information from leaking.

Core Features & Use Cases

  • External-ready rewriting: Creates new files (never edits the original) by reorganizing and de-contextualizing Markdown for audiences without project context.
  • Privacy and safety guardrails: Scans for sensitive patterns (e.g., tokens/passwords/emails/internal URLs/IPs) and halts writing when high-risk items are detected.
  • Link and image policy handling: Removes internal links, preserves external URLs, warns about relative Markdown links in single-file mode, and applies consistent rules for images.

Quick Start

Run rewrite-external on a Markdown file or folder to generate a new external-facing rewritten copy in the configured output directory.

Frequently Asked Questions about rewrite-external

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert internal Markdown documentation into external-facing versions for third-party readers?

Yes, you can batch rewrite Markdown documents across an entire directory. The Skill supports directory-wide batch processing and glob-based file selection, allowing you to generate external-facing Markdown copies for multiple files simultaneously while maintaining content integrity.

Does rewriting internal Markdown for external sharing remove sensitive information like passwords and internal URLs?

Rewriting internal Markdown applies privacy guardrails that scan for sensitive patterns including passwords, tokens, emails, and internal IPs. It halts writing when high-risk items are detected, preventing sensitive information from leaking into external documents.

How are internal links and images handled when preparing external Markdown documents?

When preparing external Markdown documents, internal links are removed and external URLs are preserved. The Skill also warns about relative Markdown links in single-file mode and applies consistent handling rules for images to ensure external readability.

What is the best way to de-contextualize internal Markdown notes for audiences without project context?

A limitation of rewriting internal Markdown is that it only processes Markdown files and operates with read-only access to the source. Additionally, the process blocks writing if high-risk sensitive information is detected, requiring source cleanup before proceeding.