talk-normal

An installer for workspace rules that make an AI agent write more directly and with less unnecessary wording in English and Chinese. The rules are added to the workspace's AGENTS.md file, which stores instructions for coding agents.

In plain words
What is it for?
Use it once to install or update the writing rules, or run the uninstall option to remove them. It is a setup tool, not a workflow used for each request.
Why use it?
It reduces verbose, corporate-sounding replies while keeping the existing instructions in that file intact.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/hexiecs/talk-normal/skill
Any agent
npx skills add hexiecs/talk-normal --skill skill
Clone the repo
git clone --depth 1 https://github.com/hexiecs/talk-normal

Made for: Claude Code, Codex.

Per session 59 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 915 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00059 $0.00915
Opus 5 $0.00030 $0.00458
Sonnet 5 $0.00012 $0.00183
Haiku 4.5 $0.00006 $0.00092

Measured yesterday against content hash 6c9e2d00e55c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

talk-normal scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

The scan reads SKILL.md. This mod also ships 1 executable file (install.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skill/SKILL.md · 75 lines

How it starts

The opening of the file, as written. The whole thing — 75 lines — stays where its author put it; the contents beside it link to each section on GitHub.

talk-normal

A curated system prompt that stops your LLM from writing like a LinkedIn post. Measured: 71% character reduction on GPT-4o-mini, 56% on GPT-5.4, across 10 prompts in English and Chinese, without losing information.

What this skill does

When invoked, this skill installs the talk-normal rules into your workspace's AGENTS.md file as an always-on behavior modifier. After install, every reply your OpenClaw agent produces follows the rules in prompt.md. The rules live between # --- talk-normal BEGIN --- and # --- talk-normal END --- markers so they do not conflict with your existing rules in AGENTS.md.

This is not a workflow skill you invoke per turn. It is a one-time installer that makes your agent permanently less verbose until you uninstall.

How to run

To install or update talk-normal in the current workspace:

bash install.sh

The script is idempotent: running it again replaces the existing talk-normal block in place with the latest rules. Nothing else in your AGENTS.md is touched.

To remove:

bash install.sh --uninstall

What gets installed

The contents of prompt.md get injected into your AGENTS.md. The rules target the specific slop patterns that make LLM output sound corporate and padded, grouped into a few categories:

  • Filler and hedging — banned opening phrases ("Great question", "I'd be happy to", "让我们一起来看看"), no throat-clearing, no restating the question
  • Structural discipline — lead with the answer, match depth to complexity, use bullets only when content is genuinely parallel, cap explanations for conceptual questions
  • Closing patterns — no "In summary" / "Hope this helps" / "综上所述", no hypothetical follow-up offers, no conditional next-step menus ("If you want I can also...")
  • Rhetorical tics — no "不是X,而是Y" / reject-then-correct framing in any variant, no plain-language restatements ("翻成人话", "in other words")
  • Shape of comparisons — give a recommendation with brief reasoning, cap pros/cons lists, no balanced-essay posture

Read the full file on GitHub · 75 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 75 lines · 59 tokens per session scan A 6c9e2d00e55c

Subscribe to this mod's changes

talk-normal is a skill published in the GitHub repository hexiecs/talk-normal (1,833 stars, last pushed 4mo ago), licensed MIT. It adds 59 tokens to every session and 915 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

prompt-optimization

Use this skill when the user wants to optimize, modify, or improve the system prompt of an AI agent. This includes requests like 'optimize the prompt', 'make the AI more focused on X', 'change the system prompt', 'improve the agent behavior', or 'modify how the AI responds'.

wecode-ai/Wegent · 62 tokens

shuorenhua

检查和清理中英文文本里的 AI 套路,适用于“去 AI 味”“说人话”“自然一点”“别像模板”“先标问题”这类改写和审稿需求;按场景控制力度,同时保留事实、术语、语域和责任主体。.

MrGeDiao/shuorenhua · 68 tokens

superpowers-zh

Use when constraining AI coding with Chinese TDD methodology, systematic debugging, code review, and verification workflows. Superpowers-zh: Chinese adaptation of the Superpowers AI-assisted programming skills and methodologies.

znlgis/opengis-skills · 45 tokens

ast-grep

Guide for writing ast-grep rules to perform structural code search and analysis. Use when users need to search codebases using Abstract Syntax Tree (AST) patterns, find specific code structures, or perform complex code queries that go beyond simple text search. This skill should be used when users ask to search for…

JanDeDobbeleer/oh-my-posh · 80 tokens

oh-my-posh

Install, configure, or troubleshoot Oh My Posh/ohmyposh: shell init, themes, segments, Nerd Font icons, and prompt setup on PowerShell, zsh, bash, or fish.

JanDeDobbeleer/oh-my-posh · 47 tokens

chinese-git-workflow

国内 Git 平台配置参考——Gitee、Coding.net、极狐 GitLab、CNB 的 SSH/HTTPS/凭据/CI 接入差异与镜像同步配置。仅在用户显式 /chinese-git-workflow 时调用,不要根据上下文自动触发。.

jnMetaCode/superpowers-zh · 69 tokens