writing-humanizer AGENTS.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What this repository is

A cross-tool plugin (not an application). It ships a single user-invocable skill, writing-humanizer, that detects and rewrites AI-generated writing patterns, focused on Traditional Chinese (Taiwan). There is no build, lint, test, or runtime — the "code" is Markdown prompt content that the host (Claude Code, OpenAI Codex, Cursor, Google Antigravity CLI, OpenCode, Kimi CLI, or pi) loads as a skill. Changes are validated by reading them and by exercising the skill, not by a toolchain.

The same skills/ directory and SKILL.md format are shared by all hosts (Claude Code, OpenAI Codex, Cursor, Google Antigravity CLI, OpenCode, Kimi CLI, pi); only the manifest/loader differs per host.

Repository layout

• .claude-plugin/plugin.json — Claude Code plugin manifest. Distributed via the shyuan-marketplace.
• .codex-plugin/plugin.json — OpenAI Codex plugin manifest. Points at the shared skills dir via "skills": "./skills/".
• .cursor-plugin/plugin.json — Cursor plugin manifest (Cursor 2.5+). Points at the shared skills dir via "skills": "skills/".
• plugin.json (repo root) — Google Antigravity CLI plugin manifest. Antigravity expects this at the plugin root (not in a namespaced dir); "skills" is an array pointing at each skill dir (["skills/writing-humanizer"]).
• package.json + .opencode/plugins/writing-humanizer.js + .opencode/INSTALL.md — OpenCode loader. OpenCode does not read the top-level skills/ dir; instead it installs this repo as a JS plugin (via the plugin array in the user's opencode.json, resolved through package.json's "main"), and the plugin's config hook injects skills/ into config.skills.paths so the skill is auto-discovered — no symlinks. See .opencode/INSTALL.md.
• .kimi-plugin/plugin.json — Kimi CLI plugin manifest. Points at the shared skills dir via "skills": "./skills/", plus a Kimi-specific interface block for display metadata. (We omit Kimi's optional sessionStart so the skill loads on demand, and skillInstructions since the skill references no host-specific tools.)
• .pi/extensions/writing-humanizer.ts + the "pi" field in package.json — pi loader. Like OpenCode, pi does not read the top-level skills/ dir on its own; the TS extension's resources_discover hook returns skillPaths: [skillsDir] to register the shared skills/ dir. package.json's "pi" field lists the extension and skills paths.
• skills/writing-humanizer/SKILL.md — the skill entry point (hub), used by all seven hosts. Its YAML frontmatter (name, description) drives triggering on all of them; Claude-specific keys (user-invocable, argument-hint, allowed-tools) are ignored by the others.
• skills/writing-humanizer/references/ — spoke files loaded on demand by the hub.
• README.md — bilingual (English + 中文) user-facing docs, kept in sync with the pattern catalog.