Individual skill
readme-benefit-writer
Use when asked to rewrite a README so strangers understand why they should care, turn a feature list into benefits, make a side project's README convincing, or explain what users get rather than what the code does. Rewrites an existing README so every feature is stated as a user benefit in plain sentences, and produces a one-line pitch, a Why section, a benefit-led feature list, a quick start, a Your data section and a contribution pointer. For a README written from scratch with badges, usage and install sections, use readme-writer.
skills/readme-benefit-writer/SKILL.md
Source commit f7c90bc09ee05dc25cf257bdb1826f2c2552c2cb
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 9, 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)
- 1,540
- Repository last updated
- Nov 10, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- product-management Repository topic
- productivity Repository topic
- skills Repository topic
- claude-skills Repository topic
- agent-skills Repository topic
- chatgpt Repository topic
- claude-code Repository topic
- cursor Repository topic
- gemini Repository topic
- prompt-engineering Repository topic
- data Derived category
- docs 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
SKILL.mdcore · 4,385 bytes
Read excerpt
# README Benefit Writer
Most side-project READMEs describe the code ("built with React, uses SQLite, supports webhooks") when a stranger wants to know what changes for them ("your notes stay on your laptop and sync when you are back online"). This skill rewrites an existing README so each feature is stated as a benefit to a named user, in plain sentences, without losing the facts a developer needs.
## Required Inputs
Ask for these if not provided:
- **The current README** (or the repo's description and feature list)
- **Who it is for**: the one kind of person most likely to install it
- **What they do today instead**: the tool, spreadsheet or habit this replaces
- **Where data goes**: what is stored, where, and whether anything leaves the user's machine
- **How to contribute**: CONTRIBUTING file, issue labels, or "not accepting PRs yet"
## Working from a brief