Prose
static-web-server/static-web-server
Author or edit any prose for the Static Web Server (SWS) project — documentation, design docs, READMEs, PR descriptions, issue bodies, commit message bodies, or other human-readable text — following…
Write prose a reviewer can read once. An agent skill from dxos/dxos.
Install Readable Prose
$ npx skills add dxos/dxos --skill readable-prose -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install dxos/dxos readable-prose --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/dxos/dxos.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/readable-prose .claude/skills/readable-prose && rm -rf skills-srcUse ~/.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/
Install the "readable-prose" agent skill from https://github.com/dxos/dxos/tree/main/.agents/skills/readable-prose into .claude/skills/readable-prose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "readable-prose", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/dxos/dxos/tree/main/.agents/skills/readable-proseType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add dxos/dxos --skill readable-prose -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install dxos/dxos readable-prose --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dxos/dxos.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/readable-prose .agents/skills/readable-prose && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "readable-prose" agent skill from https://github.com/dxos/dxos/tree/main/.agents/skills/readable-prose into .agents/skills/readable-prose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "readable-prose", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dxos/dxos --skill readable-prose -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install dxos/dxos readable-prose --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dxos/dxos.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/readable-prose .cursor/skills/readable-prose && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "readable-prose" agent skill from https://github.com/dxos/dxos/tree/main/.agents/skills/readable-prose into .cursor/skills/readable-prose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "readable-prose", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/dxos/dxos.git --path .agents/skills/readable-prose--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add dxos/dxos --skill readable-prose -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install dxos/dxos readable-prose --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dxos/dxos.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/readable-prose .gemini/skills/readable-prose && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "readable-prose" agent skill from https://github.com/dxos/dxos/tree/main/.agents/skills/readable-prose into .gemini/skills/readable-prose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "readable-prose", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install dxos/dxos readable-proseInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add dxos/dxos --skill readable-prose -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/dxos/dxos.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/readable-prose .github/skills/readable-prose && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "readable-prose" agent skill from https://github.com/dxos/dxos/tree/main/.agents/skills/readable-prose into .github/skills/readable-prose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "readable-prose", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dxos/dxos --skill readable-prose -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install dxos/dxos readable-prose --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dxos/dxos.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/readable-prose .opencode/skills/readable-prose && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "readable-prose" agent skill from https://github.com/dxos/dxos/tree/main/.agents/skills/readable-prose into .opencode/skills/readable-prose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "readable-prose", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
readable-prose- GitHub stars
- 525
- Token cost
- ~1k tokens
- SKILL.md length
- 599 words
- Files
- 1
- Skills in repo
- 41
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Write prose a reviewer can read once. An agent skill from dxos/dxos.
- Works in 9 steps: Lead with the answer. The finding, the… → One idea per sentence. If the reader has… → Say the mechanism, not the feeling. Not… → …
- Writing a PR body
- SKILL.md covers The moves, Words that mark generated text, Before you send and Checking it, plus 1 more section
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Readable Prose is an agent skill from dxos/dxos. Write prose a reviewer can read once. Use when writing a PR body, a commit message, a walkthrough, a design doc, a review comment, or a chat reply that runs past a couple of sentences.
Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Pull requests, Commit messages and Architecture decision records. The repository describes itself as: TypeScript implementation of the DXOS protocols, SDK, toolchain and Composer.
When your agent uses it
- Writing a PR body
- A commit message
- A review comment
- A chat reply that runs past a couple of sentences
Example prompts
- “/readable-prose”
Workflow steps
9 steps, taken from the first numbered list in SKILL.md.
- Lead with the answer. The finding, the decision, the number. Context after, and only what
- One idea per sentence. If the reader has to backtrack, split it or drop a clause. Past ~30
- Say the mechanism, not the feeling. Not "the retry makes this more robust" but "the second
- Ground a term before leaning on it. Name the idea and the word together, once, then reuse the
- Active voice, named actor. "The compiler validates queries", not "queries are validated".
- Plain word over fancy. use over utilize, help over facilitate, many over numerous, if over in
- Structure carries structure. A heading, a list or a table where the shape repeats; prose where
- Cut the connective em dash. End the sentence or use a comma. (This repo's older docs are full
- Bold leads end in a period and add new detail. `Schema in TypeScript. Tables live in one
What it can do on your machine
Read from SKILL.md and the folder at commit f0fc12a. 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
Links to these hosts (documentation or services it may open):
github.com
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
Readable Prose loads about 1k tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 599 words of instructions outside code blocks.
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
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 599 words (~1,048 tokens).
“The reader's time is the scarce resource, and review is the bottleneck. Every sentence spends it. A paragraph that takes two passes to parse has already failed, however accurate it is.”
- name
- readable-prose
Files
Just SKILL.md in .agents/skills/readable-prose of dxos/dxos.
Open the folder on GitHubat commit f0fc12a
Compare with similar skills
Readable Prose 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Readable Prose this skilldxos/dxos | 525 | — | ~1k | Automated safety check: Pass | Custom licence | |
| Prosestatic-web-server/static-web-server | 2.4k | — | ~971 | Automated safety check: Pass | Apache-2.0 | |
| PR Design DocOpenHands/OpenHands | 90k | — | ~2.4k | Automated safety check: Pass | MIT | |
| PR Finalize Reviewmicrosoft/garnet | 12k | — | ~3.1k | Automated safety check: Pass | MIT | |
| Git Workflow and Versioningaddyosmani/agent-skills | 103k | 2 repos | ~3.5k | Automated safety check: Notes | MIT | |
| React Router Pull Request Creatorremix-run/react-router | 57k | — | ~2.5k | Automated safety check: Pass | MIT |
Similar skills
PR Design Doc
OpenHands/OpenHands
For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…
- Official
PR Finalize Review
microsoft/garnet
Checks that a pull request's title and description match its implementation and reviews the code for Garnet best practices, reporting findings without posting them.
Git Workflow and Versioning
addyosmani/agent-skills
Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.
React Router Pull Request Creator
remix-run/react-router
Packages finished React Router work into a draft pull request: branch, commit, push, a written PR body and the right GitHub labels.
Verdaccio Pull Request Workflow
verdaccio/verdaccio
Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.
More from dxos/dxos
All 41 skills in this repoAgentic Review
dxos/dxos
Run the rule-driven agentic code review — discover rule blocks in the repo's .mdl files, prepare per-rule review groups (full project by default; diff-only with --pr-only), spawn one focused Sonnet…
Composer Forensics
dxos/dxos
Forensically inspect and repair Composer browser profiles — offline (Chrome OPFS / SQLite extract) or live via /recovery.html debug port.
Migrate Oxfmt
dxos/dxos
Guide for migrating a project from Prettier or Biome to Oxfmt.
Moon
dxos/dxos
This skill should be used when the user asks to "configure moon", "set up moonrepo", "create moon tasks", "run moon commands", "configure moon workspace", "add moon project", "moon ci setup", "moon…
Subduction Policy
dxos/dxos
Reference for SubductionPolicy (the four hooks authorizeConnect, authorizeFetch, authorizePut, filterAuthorizedFetch passed via Subduction.hydrate(..., policy) or new Repo({ subductionPolicy })).
Autocue
dxos/dxos
Record a demo of the running app that the agent drives itself — a .mdl QA test or an ad-hoc walkthrough — as a captioned .webm (or a screenshot), trimmed of dead air and ready to attach.
Related
Categories
Questions about Readable Prose
What does Readable Prose do?
Write prose a reviewer can read once. An agent skill from dxos/dxos. Readable Prose is an agent skill from dxos/dxos. Write prose a reviewer can read once.
When should I use Readable Prose?
Readable Prose fits situations like: writing a PR body; A commit message; A review comment; A chat reply that runs past a couple of sentences.
How do I install Readable Prose in Claude Code?
Run `npx skills add dxos/dxos --skill readable-prose -a claude-code`. Or copy the skill folder (.agents/skills/readable-prose in dxos/dxos) into .claude/skills/readable-prose in your project. Claude Code loads it when a task matches its description.
How do I install Readable Prose in Codex?
Run `npx skills add dxos/dxos --skill readable-prose -a codex`. Or copy the skill folder (.agents/skills/readable-prose in dxos/dxos) into .agents/skills/readable-prose in your project. Codex loads it when a task matches its description.
Can I use Readable Prose 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 dxos/dxos --skill readable-prose -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/readable-prose, .gemini/skills/readable-prose, .github/skills/readable-prose and .opencode/skills/readable-prose in your project.
What does Readable Prose need to run?
SKILL.md names no scripts, command-line tools or credentials: Readable Prose is instructions for the agent only.
Does Readable Prose access the network?
SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.
Is Readable Prose 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 Readable Prose use?
Readable Prose has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Readable Prose use?
About 1k tokens (SKILL.md is roughly 4.2k 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 Readable Prose?
Skills that share tags, products or a category with Readable Prose: Prose (static-web-server/static-web-server, 2.4k stars), PR Design Doc (OpenHands/OpenHands, 90k stars), PR Finalize Review (microsoft/garnet, 12k stars) and Git Workflow and Versioning (addyosmani/agent-skills, 103k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Readable Prose?
dxos (a GitHub organization) maintains it in dxos/dxos, which has 525 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on October 8, 2026.
Source: dxos/dxos on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.