← All skills

repository-readme-writer

95 / 100 · Low risk

Fine to try.

By jpcaparas/skills (GitHub) · writing · 57 stars · scanned at commit e1b479a

Creates, rewrites or reviews repository READMEs: quickstart, local setup, getting started, contributor basics, grounded in what the repo contains and safe for agents to read. Not for API reference, product docs, changelogs or landing pages.

Works with any agent that supports SKILL.md skills.

What this skill can do

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'repository-readme-writer' ] || [ -L ~/.agents/skills/'repository-readme-writer' ]; then echo 'A skill folder named repository-readme-writer already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/jpcaparas/skills' "$d" && git -C "$d" checkout --quiet 'e1b479afa6c172f6d5a6087b6e19d7c0580b8a4e' -- 'skills/writing/repository-readme-writer' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills/writing/repository-readme-writer' ~/.agents/skills/'repository-readme-writer' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'repository-readme-writer' ~/.claude/skills/'repository-readme-writer' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for jpcaparas/skills shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/jpcaparas/skills.svg)](https://zalavijaysinh.github.io/skilltrust/repos/jpcaparas/skills/)

Score history