Skip to content

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

xoHumanize

Clear writing. Your voice.

A standalone writing skill for editing drafts, matching your voice, and preserving what you mean. Use it for emails, articles, reports, documentation, or stories.

The skill contains instructions and focused references. It runs inside a compatible agent harness using that harness's model, login, and tools. There is no application to run or separate API key to configure.

Install

In Codex, ask the skill installer:

$skill-installer install the skill at https://github.com/Yuezhiui/xoHumanize/tree/main/xohumanize

For manual installation, copy the entire xohumanize/ folder into ~/.agents/skills/ (on Windows, %USERPROFILE%\.agents\skills\). Keep its references and metadata together. Follow your host's installation instructions for other compatible harnesses.

Use

$xohumanize
Edit this:

[paste your draft]

Editing defaults to Light and follows the voice of your draft. Specify the audience, tone, length, or format when needed.

Level What changes
Light Grammar, obvious filler, and awkward wording. Keeps most phrasing and organization.
Standard / medium Sentences and paragraphs, repetition, and flow.
Deep / hard Wording and structure throughout the piece, for its intended audience and purpose.

All levels preserve substantive meaning, facts, citations, qualifications, and the author's position. Intensity controls the extent of editing, not a detector score.

$xohumanize
Use hard editing. Keep the tone formal and preserve the technical details:

[paste your draft]

For new writing, provide a topic or notes:

$xohumanize
Draft a short release note from these changes:

[paste your notes]

Voice and review

The skill follows your explicit voice instructions, a supplied profile or relevant writing samples, or the voice of the draft. For new writing without samples, it chooses a tone suited to the audience and purpose. It cannot establish your personal voice from a topic alone.

Ask it to analyze your writing samples and build a reusable voice profile. To reuse that profile across chats, ask the harness to save it to a private file and load that file in the next chat. Keep profiles and drafts outside the distributed skill folder.

Finished prose is the default output. You can also request a diagnosis without rewriting, an edit of one passage, a before/after comparison, or a review of changes in meaning and detail.

In Codex, use $xohumanize or select it through /skills. Command syntax depends on the host. See the official skills guide.

Skill files

  • SKILL.md: tasks, defaults, editing levels, and fidelity requirements.
  • Writing rules: guidance for natural prose across genres.
  • Voice: sample analysis and reusable profiles.
  • Review: diagnosis, comparisons, and fidelity checks.
  • Codex metadata: display name and suggested prompt.

xoHumanize does not guarantee AI-detector results or invent experiences to make writing sound personal. Review important edits against your source.

License

MIT. Copyright (c) 2026 Yuezhiui.

About

A writing skill and web editor that cut filler, match your voice, and keep your meaning intact.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors