Imported from royalpinto007/ship-skills (skills/readme-that-converts/SKILL.md). Install upstream with npx skills add royalpinto007/ship-skills --skill readme-that-converts. Copyright stays with the author.

README That Converts

Name: readme-that-converts
Author: royalpinto007

The README is the product's front door. A visitor decides in ten seconds whether to try it. You make those seconds count.

Before you start

Read .agents/ship.md.

The first screen (in order)

Name + one line: what it is and who it is for, in a single sentence. No throat-clearing.
Badges: CI (green), version (npm or PyPI), license. They signal maintained and installable.
The problem, in two sentences: the pain, concretely, then the payoff.
A demo asset: a GIF, screenshot, or a copy-pasteable one-command example that shows it working. This is the highest-converting element; leave a clear slot even if the asset comes later.
Quickstart: install and run in under 30 seconds, copy-pasteable, tested from a clean checkout.

Then

Usage, options, how it works, contributing, license. Be honest about scope and limitations; overclaiming loses trust fast.

Done when

The first screen answers what, why, and how-to-run without scrolling, badges are live, and the quickstart actually works when pasted fresh.

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

{ "ocm": "1", "id": "royalpinto007-ship-skills-readme-that-converts", "kind": "skill", "name": "readme-that-converts", "description": "When a repo's README does not sell or explain the project in its first screen. Triggers: 'improve the README', 'README as landing page', 'my readme is weak', 'readme that converts'. Rewrites the top of the README to say what, why, and how fast, with badges and a demo slot.", "publisher": "royalpinto007", "version": "1.0.0", "capabilities": { "domains": [ "marketing" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "When a repo's README does not sell or explain the project in its first screen. Triggers: 'improve the README', 'README as landing page', 'my readme is weak', 'readme that converts'. Rewrites the top of the README to say what, why, and how fast, with badges and a demo slot." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/royalpinto007/ship-skills", "path": "skills/readme-that-converts/SKILL.md", "ref": "515054414c0c26001b093dd11e04bf09785b4ada", "url": "https://github.com/royalpinto007/ship-skills/blob/515054414c0c26001b093dd11e04bf09785b4ada/skills/readme-that-converts/SKILL.md", "key": "royalpinto007/ship-skills/skills/readme-that-converts/SKILL.md" } }, "instructions": "# README That Converts\n\nThe README is the product's front door. A visitor decides in ten seconds whether to try it. You make those seconds count.\n\n## Before you start\n\nRead `.agents/ship.md`.\n\n## The first screen (in order)\n\n1. **Name + one line:** what it is and who it is for, in a single sentence. No throat-clearing.\n2. **Badges:** CI (green), version (npm or PyPI), license. They signal maintained and installable.\n3. **The problem, in two sentences:** the pain, concretely, then the payoff.\n4. **A demo asset:** a GIF, screenshot, or a copy-pasteable one-command example that shows it working. ", "cost": { "context_tokens": 269 } }

readme-that-converts

About

README That Converts

Before you start

The first screen (in order)

Then

Done when

Use it

Manifest

Reviews