Agent skill

Simplified English

by paperclipai in paperclipai/paperclip

Write user-facing comments, plans, and documents in ASD-STE100 Simplified Technical English — short, unambiguous sentences with approved words and one meaning each — so readers understand them the…

MITAuto-check passed

Install Simplified English

skills CLI
$ npx skills add paperclipai/paperclip --skill simplified-english -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install paperclipai/paperclip simplified-english --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/paperclipai/paperclip.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/skills-catalog/catalog/optional/content/simplified-english .claude/skills/simplified-english && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
simplified-english
GitHub stars
100k
Token cost
~392 tokens
SKILL.md length
154 words
Files
1
Skills in repo
60
Repo updated
First seen
Licence
MIT

At a glance

Write user-facing comments, plans, and documents in ASD-STE100 Simplified Technical English — short, unambiguous sentences with approved words and one meaning each — so readers understand them the…

  • SKILL.md covers Core rules and Approved words
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Simplified English is an agent skill from paperclipai/paperclip. Write user-facing comments, plans, and documents in ASD-STE100 Simplified Technical English — short, unambiguous sentences with approved words and one meaning each — so readers understand them the first time.

Its SKILL.md is about 390 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: The open-source app everyone uses to manage agents at work. The licence is MIT.

Example prompts

  • “/simplified-english”

What it can do on your machine

Read from SKILL.md and the folder at commit de9ab8e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Simplified English loads about 392 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 154 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~392

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from paperclipai/paperclip at commit de9ab8e, republished under its MIT licence (© paperclipai). 154 words, ~392 tokens.

Download SKILL.mdSave it as .claude/skills/simplified-english/SKILL.md (or your agent's skills folder).
name
simplified-english
description
Write user-facing comments, plans, and documents in ASD-STE100 Simplified Technical English — short, unambiguous sentences with approved words and one meaning each — so readers understand them the first time.
key
paperclipai/optional/content/simplified-english
recommendedForRoles
engineer, product, writer, devrel
tags
writing, communication, clarity, style

Simplified English

For user-facing comments, plans, and documents, write using only ASD-STE100 Simplified Technical English.

Core rules

  • Use short sentences (procedures ≤ 20 words, descriptions ≤ 25 words).
  • Give one instruction per sentence.
  • Use approved words with one meaning each; avoid synonyms and jargon.
  • Use the active voice and the present tense.
  • Use articles ("the", "a") and do not drop words to save space.
  • Write positive instructions; avoid negative or vague qualifiers.
  • Keep paragraphs to one topic.

Approved words

The approved words are the ASD-STE100 controlled vocabulary — the Dictionary in the current ASD-STE100 specification, plus the technical names and technical verbs that your subject needs. When a word is not approved, use the simplest common word that has one meaning. Prefer these house choices:

  • "start" / "stop" (not "initiate", "commence", "terminate", "kill")
  • "make" (not "implement", "leverage", "utilize")
  • "before" / "after" (not "prior to", "subsequent to")
  • "about" (not "regarding", "in relation to")
  • "help" (not "facilitate")
  • "use" (not "utilize", "employ")

© paperclipai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/skills-catalog/catalog/optional/content/simplified-english of paperclipai/paperclip.

Open the folder on GitHubat commit de9ab8e

Compare with similar skills

Simplified English next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Simplified English compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Simplified English this skillpaperclipai/paperclip100k—~392Automated safety check: PassMIT
Simplified Technical Englishsuperplanehq/superplane7.7k—~1.4kAutomated safety check: PassCustom licence
Plancodewhale-hq/Codewhale41k—~213Automated safety check: PassMIT
Writing Simplified Technical EnglishPostHog/posthog40k—~1.4kAutomated safety check: PassCustom licence
Asd Ste100danyuchn/asd-ste100-skill4.3k—~4.1kAutomated safety check: PassMIT
Planningn8n-io/n8n207k—~2.5kAutomated safety check: PassCustom licence

Similar skills

  • Simplified Technical English

    superplanehq/superplane

    Write user-facing and reviewer-facing technical text in ASD-STE100 Simplified Technical English style.

    7.7k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Plan

    codewhale-hq/Codewhale

    Turn a sufficiently understood task into an ordered implementation plan with dependencies and verification.

    41k GitHub stars~213 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Official

    Write English that a reader cannot misread: one meaning per word, active voice, simple tenses, one idea per sentence, short sentences.

    40k GitHub stars~1.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Asd Ste100

    danyuchn/asd-ste100-skill

    A skill your agent uses when English text must be parsed without a human to resolve ambiguity — tool descriptions, error messages, inter-agent instructions, system prompts, status reports — and…

    4.3k GitHub stars~4.1k tokensUpdated 7 days ago
    Writing & ContentAuto-check passed
  • Planning

    n8n-io/n8n

    Official

    ONLY for coordinated multi-artifact work: multiple workflows with dependencies, shared data-table schema/migration across tasks, or the user explicitly asked to review a plan first.

    207k GitHub stars~2.5k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Plan

    asgeirtj/system_prompts_leaks

    On an explicit planning request, always call readskill for this skill before answering.

    69k GitHub stars~5.1k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from paperclipai/paperclip

All 60 skills in this repo
  • Garden Inbox

    paperclipai/paperclip

    Scan a Paperclip user's Mine inbox, classify reversible archive candidates, request checkbox confirmation, and archive only accepted selections.

    100k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Paperclip

    paperclipai/paperclip

    Interact with the Paperclip control plane API for task coordination and governance.

    100k GitHub stars~9.6k tokensUpdated today
    Auto-check passed
  • Paperclip

    paperclipai/paperclip

    A skill your agent uses for Paperclip-managed tasks and heartbeats: reading task context, delivering task documents or files, updating completion or blockers, coordinating or delegating work, and…

    100k GitHub stars~18k tokensUpdated today
    Auto-check passed
  • Design Guide

    paperclipai/paperclip

    Paperclip UI design system guide for building consistent, reusable frontend components.

    100k GitHub starsUsed in 1 repo~3.1k tokens
    Auto-check passed
  • Paperclip Page

    paperclipai/paperclip

    Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host.

    100k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Paperclip Create Agent

    paperclipai/paperclip

    Create new agents in Paperclip with governance-aware hiring.

    100k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed

Questions about Simplified English

What does Simplified English do?

Write user-facing comments, plans, and documents in ASD-STE100 Simplified Technical English — short, unambiguous sentences with approved words and one meaning each — so readers understand them the…. Simplified English is an agent skill from paperclipai/paperclip. Write user-facing comments, plans, and documents in ASD-STE100 Simplified Technical English — short, unambiguous sentences with approved words and one meaning each — so readers understand them the first time.

How do I install Simplified English in Claude Code?

Run `npx skills add paperclipai/paperclip --skill simplified-english -a claude-code`. Or copy the skill folder (packages/skills-catalog/catalog/optional/content/simplified-english in paperclipai/paperclip) into .claude/skills/simplified-english in your project. Claude Code loads it when a task matches its description.

How do I install Simplified English in Codex?

Run `npx skills add paperclipai/paperclip --skill simplified-english -a codex`. Or copy the skill folder (packages/skills-catalog/catalog/optional/content/simplified-english in paperclipai/paperclip) into .agents/skills/simplified-english in your project. Codex loads it when a task matches its description.

Can I use Simplified English in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add paperclipai/paperclip --skill simplified-english -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/simplified-english, .gemini/skills/simplified-english, .github/skills/simplified-english and .opencode/skills/simplified-english in your project.

What does Simplified English need to run?

SKILL.md names no scripts, command-line tools or credentials: Simplified English is instructions for the agent only.

Does Simplified English access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Simplified English safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Simplified English use?

Simplified English is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Simplified English use?

About 392 tokens (SKILL.md is roughly 1.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Simplified English?

Skills that share tags, products or a category with Simplified English: Simplified Technical English (superplanehq/superplane, 7.7k stars), Plan (codewhale-hq/Codewhale, 41k stars), Writing Simplified Technical English (PostHog/posthog, 40k stars) and Asd Ste100 (danyuchn/asd-ste100-skill, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Simplified English?

paperclipai (a GitHub organization) maintains it in paperclipai/paperclip, which has 99,905 GitHub stars. The repository holds 60 skills in this directory. The repository was last updated on October 11, 2026.

Source: paperclipai/paperclip on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.