Individual skill
readable-code
Readable code rules inspired by The Art of Readable Code, for any language with TypeScript/JavaScript as the primary focus. Use when writing, reviewing, or refactoring code in TS, JS, React/JSX, Node, Python, or any other language, including when the user asks to clean up, simplify, untangle, or make code easier to follow. Enforces short functions, flat control flow, clear naming, readable structure, and language idioms.
skills/readable-code/SKILL.md
Source commit a5441d3a5d40eb00d5c219404d3ae4406be048c7
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- Yes
- Observed behavior
- Not checked yet
- Last checked
- Nov 6, 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.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 21
- Repository last updated
- Nov 2, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- agentic-coding Repository topic
- agentic-skills Repository topic
- ai-agents Repository topic
- claude-code Repository topic
- claude-skills Repository topic
- codex Repository topic
- codex-skills Repository topic
- skills Repository topic
- writing Derived category
- engineering Derived category
- engineering-web 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
README.mddoc · 271 bytesSKILL.mdcore · 9,366 bytesagents/openai.yamlasset · 308 bytesassets/readable-code.pngasset · 1,674 bytesreferences/python.mddoc · 3,217 bytesreferences/typescript.mddoc · 5,556 bytes
Read excerpt
# Readable Code Rules (/readable-code)
Apply these rules when writing, reviewing, or refactoring code. Inspired by
_The Art of Readable Code_ by Dustin Boswell and Trevor Foucher.
**Core principle: Code should be easy to understand.** The time it takes someone
else (or future you) to understand the code is the ultimate metric.
## How to Apply
- The general rules below apply to every language. Examples use TypeScript.
- Load the language reference for idioms:
- TypeScript / JavaScript / JSX: [references/typescript.md](references/typescript.md)
- Python: [references/python.md](references/python.md)