Skip to content

Revise README for Humanizer installation instructions #145

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nisrulz wants to merge 2 commits into
base: main
Choose a base branch
from
+16 −24
Open

Revise README for Humanizer installation instructions #145

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
27ebd4f
Revise README for Humanizer installation instructions
nisrulz Jun 10, 2026
baef3da
Add update section to README
nisrulz Jun 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 16 additions & 24 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,43 +1,35 @@
# Humanizer

A skill for Claude Code and OpenCode that removes signs of AI-generated writing from text, making it sound more natural and human.
A skill for coding agents (Claude Code, OpenCode, etc) that removes signs of AI-generated writing from text, making it sound more natural and human.

## Installation

### Claude Code

Clone directly into Claude Code's skills directory:

```bash
mkdir -p ~/.claude/skills
git clone https://github.com/blader/humanizer.git ~/.claude/skills/humanizer
npx skills add blader/humanizer
```
> This will let you install for any coding agent.

Or copy the skill file manually if you already have this repo cloned:

```bash
mkdir -p ~/.claude/skills/humanizer
cp SKILL.md ~/.claude/skills/humanizer/
```
### Per-agent install

### OpenCode
If you want to install for specific agent, use the table below.

Clone directly into OpenCode's skills directory:
| Agent | Install command |
|---|---|
| **Claude Code** | `npx skills add blader/humanizer --agent claude-code` |
| **opencode** | `npx skills add blader/humanizer --agent opencode` |
| **Codex CLI** | `npx skills add blader/humanizer --agent codex` |

@nisrulz nisrulz Jun 10, 2026

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Example of terminal output:

npx skills add blader/humanizer --agent codex

███████╗██╗  ██╗██╗██╗     ██╗     ███████╗
██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝
███████╗█████╔╝ ██║██║     ██║     ███████╗
╚════██║██╔═██╗ ██║██║     ██║     ╚════██║
███████║██║  ██╗██║███████╗███████╗███████║
╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝

┌   skills 
│
◇  Source: https://github.com/blader/humanizer.git
│
◇  Repository cloned
│
◇  Found 1 skill
│
●  Skill: humanizer
│
│  Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, passive voice, negative parallelisms, and filler phrases.
│
◇  Installation scope
│  Global

│
◇  Installation Summary ───────╮
│                              │
│  ~/.agents/skills/humanizer  │
│    copy → Codex              │
│                              │
├──────────────────────────────╯
│
◇  Security Risk Assessments ───────────────────────────────╮
│                                                           │
│             Gen               Socket            Snyk      │
│  humanizer  Safe              0 alerts          Low Risk  │
│                                                           │
│  Details: https://skills.sh/blader/humanizer              │
│                                                           │
├───────────────────────────────────────────────────────────╯
│
◇  Proceed with installation?
│  Yes
│
◇  Installation complete

│
◇  Installed 1 skill ──────────────╮
│                                  │
│  ✓ humanizer (copied)            │
│    → ~/.agents/skills/humanizer  │
│                                  │
├──────────────────────────────────╯

│
└  Done!  Review skills before use; they run with full agent permissions.

| **Cursor** | `npx skills add blader/humanizer --agent cursor` |

> **Note:** OpenCode also scans `~/.claude/skills/` for compatibility, so if you use both tools, setting it up for Claude Code is enough.

```bash
mkdir -p ~/.config/opencode/skills
git clone https://github.com/blader/humanizer.git ~/.config/opencode/skills/humanizer
```
### Update

Or copy the skill file manually if you already have this repo cloned:
To sync the latest changes from the repo to the local installed skill, run the command

```bash
mkdir -p ~/.config/opencode/skills/humanizer
cp SKILL.md ~/.config/opencode/skills/humanizer/
npx skills update humanizer

@nisrulz nisrulz Jun 10, 2026

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Output:

⚡️ npx skills update humanizer 
Updating humanizer...

Checking skills from source: blader/humanizer
✓ All global skills are up to date

```

> **Note:** OpenCode also scans `~/.claude/skills/` for compatibility, so if you use both tools, a single clone into `~/.claude/skills/humanizer/` is enough.

## Usage

### Claude Code
Expand Down