Developer / open-source maintainer

README writer

Immediate result: A README with what it does, quick start, configuration, examples and contribution notes.

Problem it solvesProjects without a clear README don't get used, contributed to or understood by the next hire.

Download SKILL.md
Add this skill to
ChatGPTClaudeGeminiPerplexity

You paste

CLI in Go that resizes images in bulk; main.go, go.mod, flags: -w -h -q

You get

# imgshrink — resize thousands of images in one command

## Quick start: go install …/imgshrink@latest && imgshrink -w 1200 ./photos

| Flag | Default | Meaning | -q | 82 | JPEG quality |

About this skill

About README writer

A project without a clear README doesn't get used, contributed to or understood by the next hire. This skill reads your file tree and package file and writes one: a description that says who the project is for, a quick start in five commands or fewer, a configuration table, a usage example, troubleshooting and contribution notes. It only documents commands that exist in the files you shared and marks anything else 'to confirm'. Commit the result as README.md and your repository explains itself to newcomers, reviewers and future you. To use it, paste the skill into your assistant and send your project's file tree, package file and a sentence on what it does.

README writer AI skill for Developer / open-source maintainer: you paste "CLI in Go that resizes images in bulk; main.go, go.mod, flags: -w -h -q" and get "# imgshrink — resize thousands of images in one command"
README writer — example input and the first lines it returns. Works in ChatGPT, Claude and Gemini.
Job profile
Software engineering · Developer / open-source maintainer
Works in
ChatGPT, Claude, Gemini, Copilot, Claude Code
Format
Agent Skills (SKILL.md)
Price
Free, no sign-up
Install instructions

Copy, paste, send

  1. Cold email writerCopy skillCopied ✓1 Copy the skillPress Copy skill.
  2. ANY AI ASSISTANTSKILLPaste here, then press Enter2 Paste it into a new chatChatGPT, Claude, Gemini or Copilot.
  3. ANY AI ASSISTANT3 Send your inputSend your project's file tree.
The skill — paste this into your AI assistant
# Skill: README writer

You are running the "README writer" skill for me. I work as: Developer / open-source maintainer. What I need from you: a README with what it does, quick start, configuration, examples and contribution notes.

## When I send you my project's file tree, package file and a sentence on what it does
1. Write a one-paragraph description that says who it's for.
2. Write a quick start that works in under five commands.
3. Document configuration and environment variables in a table.
4. Add a usage example, troubleshooting and contribution section.

## Reply in this format
- README.md (one code block)

## Rules
- Only document commands that exist in the files shared; mark others 'to confirm'.
- Use only the facts I give you; mark anything you had to assume with [ASSUMPTION].
- If something essential is missing, ask me one short question, then continue.
- No preamble or filler: start with the result.

Confirm you're ready in one line, then wait for me to send my project's file tree, package file and a sentence on what it does.

Then sendYour project's file tree, package file and a sentence on what it does. For example: CLI in Go that resizes images in bulk; main.go, go.mod, flags: -w -h -q

ChatGPT

  1. Fastest: paste the skill as your first message in a new chat, then send your input.
  2. To keep it: open a Project, choose Instructions (or Settings → Personalization → Custom instructions for every chat) and paste it there.
  3. To share it with a team: create a custom GPT and paste the skill into its Instructions.
  4. In the Codex app: copy the skill's folder into ~/.codex/skills/ (or Customize → Skills → Add → Create skill).

Claude

  1. Fastest: paste the skill as your first message in a new chat, then send your input.
  2. To keep it: create a Project, open Project instructions and paste the skill.
  3. As a Claude Skill: download the skill's ZIP, then in Claude open Settings → Skills → Add → Upload skill and choose the file.

Gemini

  1. Fastest: paste the skill as your first message in a new chat, then send your input.
  2. To keep it: open Gems → New Gem, paste the skill into Instructions and save.

Microsoft Copilot

  1. Fastest: paste the skill as your first message, then send your input.
  2. In Microsoft 365 Copilot, save it as a prompt or paste it into an agent's instructions to reuse it.

Any other assistant

  1. Paste the skill as the system prompt or first message in any chat assistant (Perplexity, Meta AI, DeepSeek, Mistral, local models).
  2. Coding agents that read the Agent Skills format (SKILL.md) can load the downloaded file from their skills folder.

Install it permanently

Upload it to Claude, add it to ChatGPT's Codex app, clone it into Claude Code, or download the SKILL.md for any agent. Full guide with screenshots →

Download the ZIP and upload it in Claude. Claude then uses the skill on its own whenever a request matches.

Download ZIP

Quick setup

  1. In Claude, open Settings → Skills (under Customize).
  2. Click Add → Upload skill.
  3. Choose the ZIP — don't unzip it — and make sure the skill is switched on.
Claude Settings with Skills selected under Customize, and the Add menu open showing Upload skill, Create a skill, Create with Claude and Record your screen

Repositoryscienceofapps.com/skills/ai-skills.git · all 200 skills, one folder each, plain git over HTTPS

What it does

The steps it follows

  1. Write a one-paragraph description that says who it's for.
  2. Write a quick start that works in under five commands.
  3. Document configuration and environment variables in a table.
  4. Add a usage example, troubleshooting and contribution section.
What you get back

The reply format

  • README.md (one code block)

Rules it never breaks

  • Only document commands that exist in the files shared; mark others 'to confirm'.
  • Uses only the facts you give it and marks assumptions.
FAQs

Questions about README writer

What does the README writer skill do?

Projects without a clear README don't get used, contributed to or understood by the next hire. The skill fixes that: a README with what it does, quick start, configuration, examples and contribution notes.

How do I install README writer in ChatGPT, Claude or Gemini?

Copy the skill and paste it as the first message of a new chat, then send your input. To keep it, paste it into a ChatGPT Project or custom GPT, a Claude Project or a Gemini Gem, or upload the SKILL.md file as a Claude Skill.

What do I send README writer after installing it?

Send your project's file tree, package file and a sentence on what it does. If something essential is missing, the skill asks you one short question and then continues.

Is the README writer skill free?

Yes. It's free to copy, use and adapt, with no sign-up, and works in the free versions of ChatGPT, Claude, Gemini and Copilot.

More for software engineering
Software engineer

Stack trace debugger

ProblemA stack trace points at a line, not at the cause, and searching the error message wastes an hour.

You paste

TypeError: Cannot read properties of undefined (reading 'map') at OrderList.tsx:14

You get

Root cause: orders is undefined on first render — the fetch hasn't resolved.

Fix: const orders = data?.orders ?? []

Confirm: reload with network throttled to Slow 3G; the list renders empty, then fills.

Immediate resultThe most likely root cause, the exact line to change and a command to confirm the fix.

How to use it
Senior engineer / reviewer

Pull request reviewer

ProblemReviews either rubber-stamp a diff or drown it in style nits, and the real bugs get through.

You paste

diff: adds if (user.role = 'admin') to the permissions check

You get

Verdict: request changes.

Blocker — line 42: = assigns instead of compares, so every user becomes admin. Use ===.

Test to add: a non-admin calling DELETE /users gets 403.

Immediate resultA review ranked by severity: bugs first, then risks, then optional nits, each with a suggested fix.

How to use it
Software engineer

Unit test writer

ProblemWriting tests for existing functions is tedious, so edge cases go untested until they break in production.

You paste

Python: def slugify(title): return title.lower().replace(' ', '-') # pytest

You get

Covers: basic title, multiple spaces, leading/trailing spaces, punctuation, empty string, unicode.

def test_collapses_multiple_spaces(): assert slugify('a b') == 'a-b'

Suspected bug: 'a b' returns 'a--b' today.

Immediate resultA ready-to-run test file covering the happy path, edge cases and failures for your function.

How to use it

All 20 software engineering skillsAll 200 skillsRead it in the articleProve it: AI for Software Developers Certification (free test)

Free PDF · 74 pages · 2 editions

The Laws of UX, in one field guide

60 research-backed principles in 6 categories — what each one means, why it works on the human brain and how to use it on your own screens. Written by Sushant Singh, founder of Science of Apps, who has scaled consumer apps to lacs of users and spent 10+ years leading product across startups and digital businesses in the US, EU & India.

Pick your edition
Free. No card, no paywall — just your email.
Free PDF · 74 pages

Get Laws of UX by email

Choose your edition

You’ll also get occasional UX psychology tips. Unsubscribe anytime. Privacy policy

Free PDF · 90 pages · 2 editions

100+ Subscription Paywalls, decoded

110 real paywalls from top apps, taken apart, rated out of 5 and decoded with the Laws of UX — plus the frameworks, copy and checklists to ship your own. By Sushant Singh, founder of Science of Apps.

  • 110 paywalls rated
  • 34 Laws of UX
  • 12 frameworks

Which paywall scored 4.8 out of 5, and which scored 2.6? It’s all inside.

Pick your edition
Free. No card, no paywall — just your email.
Free PDF · 90 pages

Get 100+ Paywalls, Decoded by email

Choose your edition

You’ll also get occasional UX psychology tips. Unsubscribe anytime. Privacy policy