AGENTS.md git:20260530.0d72798A

Immutable. This exact content is served forever at /api/v1/blob/8862a369807f789c.

# AGENTS.md — Humanizer Skill

> Universal harness context file (AAIF/Linux Foundation spec). Auto-discovered by Claude Code, Cursor, Copilot, Codex CLI, Windsurf, Cline, Gemini CLI, Aider, Zed, Jules, RooCode, Factory, and 10+ other harnesses.

## What this repo is

**Humanizer** is a pure-Markdown Claude Code skill that detects 43 AI writing patterns and rewrites text to sound like a human wrote it. It scores text 0-100 (higher = more AI smell), applies one of 5 named voice profiles, and injects sentence-length burstiness. Zero dependencies. No network calls. No binaries. The entire skill is a single file: `skills/humanizer/SKILL.md`.

## File map

```
skills/
  humanizer/
    SKILL.md          # the skill — the only file you need to install
    README.md         # skill-specific docs
.claude-plugin/
  plugin.json         # Claude Code plugin manifest (name, version, author, keywords)
  marketplace.json    # single-plugin marketplace entry (installable via claude plugin marketplace add)
examples/
  blog-post/
    before.md         # raw AI-generated blog paragraph (high AI-tell score)
    after.md          # humanized output with annotations
docs/
  VIRAL-AUDIT.md      # supernova engine score/tier/gap report
  LAUNCH-PLAN.md      # June 2026 channel-sequenced launch plan
landing/              # static landing page (humanizer-skill.vercel.app)
submissions/          # awesome-list / marketplace submission drafts
```

## How to install the skill

**Project-scoped (travels with your repo):**
```bash
mkdir -p .claude/skills/humanizer && curl -sL \
  https://raw.githubusercontent.com/Aboudjem/humanizer-skill/main/skills/humanizer/SKILL.md \
  -o .claude/skills/humanizer/SKILL.md
```

**Global (available in every project):**
```bash
mkdir -p ~/.claude/skills/humanizer && curl -sL \
  https://raw.githubusercontent.com/Aboudjem/humanizer-skill/main/skills/humanizer/SKILL.md \
  -o ~/.claude/skills/humanizer/SKILL.md
```

**Via Claude Code plugin marketplace:**
```bash
claude plugin marketplace add Aboudjem/humanizer-skill
```

Claude Code auto-discovers skills in `.claude/skills/`, `~/.claude/skills/`, or any plugin's `skills/` directory. No restart needed.

## How to invoke the skill

```
/humanizer "Your AI-generated text here"
/humanizer "text" --voice casual
/humanizer "text" --mode detect --score
/humanizer --file docs/README.md --voice technical
/humanizer "text" --aggressive --iterate 3
```

The skill is invoked as `/humanizer`. It auto-triggers when a user asks to:
- "make this sound more human"
- "rewrite this to avoid AI detection"
- "check this for AI tells"
- "humanize this text"
- "clean up the AI writing in this"

## Modes

| Mode | What it does |
|:-----|:-------------|
| `rewrite` | Full transformation with voice injection (default) |
| `detect` | Scan-only — reports patterns and score, no rewrite |
| `edit` | In-place file editing with minimal changes |

## Voice profiles

| Voice | Best for |
|:------|:---------|
| `casual` | Blog posts, social media, community docs |
| `professional` | Business comms, reports, formal docs |
| `technical` | API docs, READMEs, architecture docs |
| `warm` | Tutorials, onboarding, support content |
| `blunt` | Reviews, internal comms, direct feedback |

## How to test

The skill is pure Markdown — there is no test runner. Test it manually:

1. Install the skill (see above).
2. Open Claude Code in any project.
3. Run: `/humanizer "In today's rapidly evolving landscape, AI is reshaping how we think about creativity. This groundbreaking shift represents a pivotal moment in human history." --mode detect --score`
4. Expected output: score ≥ 70/100 with patterns P1, P4, P7, P29, P30 flagged.
5. Run: `/humanizer "..." --voice casual` — verify the rewrite has shorter/varied sentences and no "pivotal"/"reshaping"/"rapidly evolving".

See `examples/blog-post/` for a documented before/after that serves as a reference test case.

## Conventions for contributors

- All 43 patterns are numbered P1–P43 in `SKILL.md`. New patterns continue the sequence.
- Every new pattern needs: a name, what to look for, and a before/after example.
- The badge count in `README.md` (`patterns-43`) must be updated when patterns are added.
- No em dashes in `SKILL.md` — the skill bans em dashes (P13), so the skill file enforces its own rules.
- CI runs a markdown lint pass and a self-check that scans `SKILL.md` for its own banned patterns.

## Cross-harness notes

- **Claude Code**: full support via `/humanizer` command.
- **Cursor / Windsurf / Continue.dev**: copy `SKILL.md` to the editor's rules/skills directory and reference in system prompt.
- **Codex CLI / Gemini CLI**: copy to the tool's skills directory (see README for per-editor install).
- **VS Code + Copilot**: paste `SKILL.md` content into your Copilot instructions.
- The skill contains no tool calls to Claude-specific APIs. All instructions are model-agnostic Markdown.

## Author

Adam Boudjemaa — [github.com/Aboudjem](https://github.com/Aboudjem) · [LinkedIn](https://www.linkedin.com/in/adam-boudjemaa/) · [X](https://x.com/AdamBoudj)