skills.rest
BaiGanio
BaiGanioCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

working-with-files

Edit non-code documents with minimal changes while preserving structure and formatting.

7|3|Updated Mar 8, 2026
Search Tags:#documents#pdf#markdown#editing#json#yaml#docx
One-click install
npx skills add https://github.com/BaiGanio/aperio --skill working-with-files
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: working-with-files
Source: https://github.com/BaiGanio/aperio/tree/main/skills/working-with-files
Command: npx skills add https://github.com/BaiGanio/aperio --skill working-with-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Editing non-code documents is error-prone when applying surgical edits across formats like Markdown, DOCX, PDF, JSON, YAML, or plain text. This skill provides disciplined, minimal-change editing that preserves surrounding content and formatting.

Core Features & Use Cases

  • Surgical edits across common document types (Markdown, DOCX, PDF, JSON, YAML, TXT) with minimal diffs.
  • Style-conscious edits that preserve whitespace, structure, and formatting.
  • Use Case: Update a policy document's section headings without altering unrelated sections or metadata.

Quick Start

Edit the target document to apply the requested changes while preserving surrounding structure and formatting.

Frequently Asked Questions about working-with-files

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

FAQPage Schema
How do I make surgical edits to a PDF or DOCX without breaking the original formatting?▼

To make surgical edits to PDF or DOCX without breaking formatting, apply minimal-change modifications that preserve surrounding structure. This approach enforces strict content integrity and per-format validations during in-place changes.

Can I update specific Markdown or YAML sections without altering unrelated metadata?▼

Yes, you can update specific Markdown or YAML sections without altering unrelated metadata by applying disciplined surgical edits. This maintains minimal diffs and preserves overall document structure and formatting.

What is the best way to apply in-place JSON document changes safely?▼

The best way to apply in-place JSON document changes safely is using a surgical editing method requiring strict adherence to content integrity and per-format validations, ensuring minimal diffs and structural preservation.

Does this surgical editing approach work across both structured and plain text documents?▼

Yes, this surgical editing approach works across structured and plain text documents. It applies to JSON, YAML, Markdown, DOCX, PDF, and TXT files, preserving structure and formatting through style-conscious edits.

Related Skills

Explore More Content & Communication Skills→
zh-xxzh-xx
159

law-to-markdown

Convert legal documents from TXT, DOCX, and PDF into structured Markdown.

Community
Advanced
idodoron11idodoron11

pr-diff

Diff the current branch against a target branch to surface PR changes.

Community
Intermediate
piers-sinclairpiers-sinclair
1

bicep-quality

Audit Bicep files for naming conventions and Azure best-practice compliance.

Community
Intermediate
sorawit-wsorawit-w
1

i18n-contextual-rewriting

Manage translation files and generate scripts for bulk localization updates.

Community
Intermediate