Individual skill

iso-24495

Use when text must be easy for its intended reader to find, understand, and act on — reports, emails, documentation, UI text, announcements, explanations, AI output that reads as dense or bureaucratic. Applies ISO 24495-1 plain language principles with dedicated technique layers for English and Traditional Chinese. Triggers: plain language rewrite, apply ISO 24495, make this clearer for readers, de-jargon this, 淺白改寫, 白話改寫, 去公文腔, 讓讀者一次看懂. Not for creative or literary writing.

SKILL.md

Read pinned source

Source commit 113656b0a6a6cbeb3b3c2bb7cf3bc29349cb05cf

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: Yes
Repository scan complete: Yes
Skill scan complete: Yes
Observed behavior: Instructions only
Last checked: Nov 11, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

Claude Code

Destination .claude/skills/iso-24495-skill

(
  set -euo pipefail
  destination='./.claude/skills/iso-24495-skill'
  if [ -e "$destination" ] || [ -L "$destination" ]; then printf '%s\n' 'Destination already exists; nothing overwritten.' >&2; exit 1; fi
  work=$(mktemp -d)
  trap 'rm -rf -- "$work"' EXIT
  git clone --filter=blob:none --no-checkout -- 'https://github.com/danyuchn/iso-24495-skill.git' "$work/repo"
  git -C "$work/repo" checkout --detach 113656b0a6a6cbeb3b3c2bb7cf3bc29349cb05cf
  git -C "$work/repo" archive --format=tar '113656b0a6a6cbeb3b3c2bb7cf3bc29349cb05cf' > "$work/skill.tar"
  mkdir -p -- './.claude/skills'
  mkdir -- "$destination"
  tar -xf "$work/skill.tar" -C "$destination"
)

Codex

Destination .agents/skills/iso-24495-skill

(
  set -euo pipefail
  destination='./.agents/skills/iso-24495-skill'
  if [ -e "$destination" ] || [ -L "$destination" ]; then printf '%s\n' 'Destination already exists; nothing overwritten.' >&2; exit 1; fi
  work=$(mktemp -d)
  trap 'rm -rf -- "$work"' EXIT
  git clone --filter=blob:none --no-checkout -- 'https://github.com/danyuchn/iso-24495-skill.git' "$work/repo"
  git -C "$work/repo" checkout --detach 113656b0a6a6cbeb3b3c2bb7cf3bc29349cb05cf
  git -C "$work/repo" archive --format=tar '113656b0a6a6cbeb3b3c2bb7cf3bc29349cb05cf' > "$work/skill.tar"
  mkdir -p -- './.agents/skills'
  mkdir -- "$destination"
  tar -xf "$work/skill.tar" -C "$destination"
)

Cursor

Destination .cursor/skills/iso-24495-skill

(
  set -euo pipefail
  destination='./.cursor/skills/iso-24495-skill'
  if [ -e "$destination" ] || [ -L "$destination" ]; then printf '%s\n' 'Destination already exists; nothing overwritten.' >&2; exit 1; fi
  work=$(mktemp -d)
  trap 'rm -rf -- "$work"' EXIT
  git clone --filter=blob:none --no-checkout -- 'https://github.com/danyuchn/iso-24495-skill.git' "$work/repo"
  git -C "$work/repo" checkout --detach 113656b0a6a6cbeb3b3c2bb7cf3bc29349cb05cf
  git -C "$work/repo" archive --format=tar '113656b0a6a6cbeb3b3c2bb7cf3bc29349cb05cf' > "$work/skill.tar"
  mkdir -p -- './.cursor/skills'
  mkdir -- "$destination"
  tar -xf "$work/skill.tar" -C "$destination"
)

Gemini CLI

Destination .gemini/skills/iso-24495-skill

(
  set -euo pipefail
  destination='./.gemini/skills/iso-24495-skill'
  if [ -e "$destination" ] || [ -L "$destination" ]; then printf '%s\n' 'Destination already exists; nothing overwritten.' >&2; exit 1; fi
  work=$(mktemp -d)
  trap 'rm -rf -- "$work"' EXIT
  git clone --filter=blob:none --no-checkout -- 'https://github.com/danyuchn/iso-24495-skill.git' "$work/repo"
  git -C "$work/repo" checkout --detach 113656b0a6a6cbeb3b3c2bb7cf3bc29349cb05cf
  git -C "$work/repo" archive --format=tar '113656b0a6a6cbeb3b3c2bb7cf3bc29349cb05cf' > "$work/skill.tar"
  mkdir -p -- './.gemini/skills'
  mkdir -- "$destination"
  tar -xf "$work/skill.tar" -C "$destination"
)

GitHub Copilot

Destination .github/skills/iso-24495-skill

(
  set -euo pipefail
  destination='./.github/skills/iso-24495-skill'
  if [ -e "$destination" ] || [ -L "$destination" ]; then printf '%s\n' 'Destination already exists; nothing overwritten.' >&2; exit 1; fi
  work=$(mktemp -d)
  trap 'rm -rf -- "$work"' EXIT
  git clone --filter=blob:none --no-checkout -- 'https://github.com/danyuchn/iso-24495-skill.git' "$work/repo"
  git -C "$work/repo" checkout --detach 113656b0a6a6cbeb3b3c2bb7cf3bc29349cb05cf
  git -C "$work/repo" archive --format=tar '113656b0a6a6cbeb3b3c2bb7cf3bc29349cb05cf' > "$work/skill.tar"
  mkdir -p -- './.github/skills'
  mkdir -- "$destination"
  tar -xf "$work/skill.tar" -C "$destination"
)

OpenCode

Destination .opencode/skills/iso-24495-skill

(
  set -euo pipefail
  destination='./.opencode/skills/iso-24495-skill'
  if [ -e "$destination" ] || [ -L "$destination" ]; then printf '%s\n' 'Destination already exists; nothing overwritten.' >&2; exit 1; fi
  work=$(mktemp -d)
  trap 'rm -rf -- "$work"' EXIT
  git clone --filter=blob:none --no-checkout -- 'https://github.com/danyuchn/iso-24495-skill.git' "$work/repo"
  git -C "$work/repo" checkout --detach 113656b0a6a6cbeb3b3c2bb7cf3bc29349cb05cf
  git -C "$work/repo" archive --format=tar '113656b0a6a6cbeb3b3c2bb7cf3bc29349cb05cf' > "$work/skill.tar"
  mkdir -p -- './.opencode/skills'
  mkdir -- "$destination"
  tar -xf "$work/skill.tar" -C "$destination"
)

Repository context

Repository stars (not skill ratings): 160
Repository last updated: Aug 13, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

agent-skills Repository topic
chinese Repository topic
claude-code Repository topic
claude-skill Repository topic
iso-24495 Repository topic
plain-language Repository topic
technical-writing Repository topic
traditional-chinese Repository topic
design Derived category
writing Derived category
docs Derived category
design-interface Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

LICENSEasset · 1,075 bytes
README.mddoc · 6,342 bytes
SKILL.mdcore · 5,664 bytes
examples/before-after-en.mddoc · 2,059 bytes
examples/before-after-zh.mddoc · 2,033 bytes
references/chinese-techniques.mddoc · 4,692 bytes
references/english-techniques.mddoc · 3,340 bytes
references/principles.mddoc · 4,307 bytes

Read excerpt


# ISO 24495-1 Plain Language (English + Traditional Chinese)

ISO 24495-1:2023 is the international standard for plain language. It defines
plain language by reader outcome, not by word lists: a document is plain when
its intended readers can get what they need (relevant), find it (findable),
understand it on first reading (understandable), and act on it (usable).

This skill rewrites text so it meets those four outcomes. The principles are
language-independent — ISO states the standard "applies to most, if not all,
written languages" — so this skill ships one shared principle layer and two
language technique layers:

- **English** → apply `references/english-techniques.md`
- **Traditional Chinese（繁體中文）** → apply `references/chinese-techniques.md`