xinbenlv

Agent Speak Readability — Development skill for Claude Code

Development community

An agent skill that makes an agent's natural-language output readable to a human: cross-language rules plus a mandatory pre-send check.

How to install Agent Speak Readability

This entry records only its repository, not the path inside it, so there is no exact command to give. Open xinbenlv/agent-speak-readability and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agent Speak Readability does

An agent skill that makes an agent's natural-language output readable to a human: cross-language rules plus a mandatory pre-send check. 让智能体写给人看的自然语言变得可读的技能。

Alternatives in Development

Internet Court Skill — The trust layer for agent-to-agent commerce — natural-language mandates, ERC-7710 delegated permissions, x402 4.9k ★
Auto — Smart router - Single entry point with natural language intent detection 2.8k ★
Shortcuts Playground Plugin — Shortcuts Playground: A Claude Code and Codex plugin for building, validating, signing, and remixing macOS/iOS 1.1k ★

README

agent-speak-readability

An agent skill that makes an agent's natural-language output readable to a human reader. The skill holds cross-language rules at the top level, Chinese rules under `lang/zh/`, and English rules under `lang/en/`. The core of the skill is a pre-send check written as edit steps, not as a quality to aim at.

The problem this skill fixes

An agent writes for itself. The agent already knows the actor, the object, the file name and the result, so the agent compresses all of them out of the sentence. The human reader does not know any of them. The text that comes out looks confident and carries almost no information.

This repository is not a style preference. This repository is a list of edits that an agent performs on a draft before the agent sends the draft.

Directory tree

agent-speak-readability/
├── README.md                      this file
├── CHANGELOG.md                   version history
├── LICENSE                        Apache License 2.0
├── SKILL.md                       skill entry point: 9 cross-language rules + the pre-send check
├── AGENTS.md                      repository-wide constraints for agents
├── CLAUDE.md                      symlink to AGENTS.md
├── docs/
│   └── suggested-claude-md-section.md   a replacement section for a user's global CLAUDE.md
└── lang/
    ├── zh/
    │   ├── PRINCIPLES.md          Chinese rules Z1 to Z10
    │   ├── ACCEPTANCE-CASES.md    four hand-written corrections, kept word for word
    │   └── NEGATIVE-SAMPLES.md    real Chinese failure samples from one session
    └── en/
        └── PRINCIPLES.md          English rules E1 to E9

How an agent uses the skill

Read SKILL.md and take the nine cross-language rules.
Read the file for the language you are about to write in. Chinese output uses lang/zh/PRINCIPLES.md. English output uses lang/en/PRINCIPLES.md.
Write the draft.
Run the ten check steps in section 4 of SKILL.md on the draft.
Run the extra chec