Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
18 changes: 18 additions & 0 deletions .github/plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
{
"name": "humanizer",
"description": "The humanizer skill, installable as a GitHub Copilot CLI plugin.",
"owner": {
"name": "blader",
"url": "https://github.com/blader"
},
"plugins": [
{
"name": "humanizer",
"description": "Remove signs of AI-generated writing from text, making it sound more natural and human. Based on Wikipedia's \"Signs of AI writing\" guide.",
"source": "./",
"category": "writing",
"tags": ["writing", "editing", "ai-detection", "humanize", "prose", "style"],
"skills": ".github/skills"
}
]
}
14 changes: 14 additions & 0 deletions .github/plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
{
"name": "humanizer",
"description": "Remove signs of AI-generated writing from text, making it sound more natural and human. Based on Wikipedia's \"Signs of AI writing\" guide.",
"version": "2.8.2",
"author": {
"name": "blader",
"url": "https://github.com/blader"
},
"homepage": "https://github.com/blader/humanizer",
"repository": "https://github.com/blader/humanizer",
"license": "MIT",
"keywords": ["writing", "editing", "ai-detection", "humanize", "prose", "style"],
"skills": ".github/skills"
}
1 change: 1 addition & 0 deletions .github/skills/humanizer/SKILL.md
5 changes: 4 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,16 @@ A portable agent skill implemented entirely as Markdown. The runtime artifact is
- `README.md` — for humans: installation, usage, a summary table of the patterns, and a version history.
- `.claude-plugin/plugin.json` — optional Claude Code plugin manifest.
- `.claude-plugin/marketplace.json` — optional single-repo marketplace entry so `/plugin marketplace add blader/humanizer` works.
- `.github/plugin/plugin.json` — optional GitHub Copilot CLI plugin manifest.
- `.github/plugin/marketplace.json` — optional single-repo marketplace entry so `/plugin marketplace add blader/humanizer` works in Copilot CLI.
- `.github/skills/humanizer/SKILL.md` — symlink to the root `SKILL.md`. Copilot CLI discovers skills under `.github/skills/`, so this exposes the skill there without a second copy; the symlink keeps `SKILL.md` the single source of truth. Leave it as a symlink (don't replace it with a copy).

## The maintenance contract

`SKILL.md` and `README.md` must stay in sync. When you change behavior or content:

- **Patterns:** the skill currently defines **33 numbered patterns**. If you add, remove, or renumber any, update the README pattern table, its "N Patterns Detected" heading, and every cross-reference in the same change. Keep numbering stable unless you are deliberately renumbering.
- **Version:** `SKILL.md` frontmatter has a `version:` field, `README.md` has a "Version History" section, and `.claude-plugin/plugin.json` has a `version` field. Bump them together so package metadata matches the skill. (`marketplace.json` intentionally omits a version so `plugin.json` stays the package source of truth.)
- **Version:** `SKILL.md` frontmatter has a `version:` field, `README.md` has a "Version History" section, and both `.claude-plugin/plugin.json` and `.github/plugin/plugin.json` have a `version` field. Bump them together so package metadata matches the skill. (Both `marketplace.json` files intentionally omit a version so the `plugin.json` files stay the package source of truth.)
- **Compatibility:** keep install and usage language harness-neutral. The skill should work in any agent harness that can load Markdown skill instructions; Claude Code, OpenCode, Codex, and other harnesses are examples, not limits.
- **Non-obvious fixes:** if you change the prompt to handle a tricky failure mode (a repeated mis-edit, an unexpected tone shift), add a short note to the README version history explaining what was fixed and why.

Expand Down
17 changes: 17 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,23 @@ Claude Code users can also install Humanizer as a plugin:

The skill is then invoked as `/humanizer:humanizer`.

### GitHub Copilot CLI

GitHub Copilot CLI users can install Humanizer as a plugin:

```
/plugin marketplace add blader/humanizer
/plugin install humanizer@humanizer
```

Or add just the skill, without the plugin wrapper:

```
/skills add https://github.com/blader/humanizer
```

Either way, `/skills list` shows `humanizer` once it is installed. Copilot loads the skill automatically when you ask it to humanize text, and you can also request it by name.

### Manual

Any agent harness can use the skill directly because the runtime artifact is `SKILL.md`. Install it wherever your harness expects skill directories, or copy `SKILL.md` into an existing skill folder.
Expand Down