Explore / Text workflows
Sample runFictional input · real output from SKILL.md
InputProject files

Project: csv-trim 0.3.1

Current README.md

# csv-trim
cleans csv. fast & production ready! works everywhere.

npm install -g csv-trim
csv-trim file

package.json (excerpt)

"bin": { "csv-trim": "bin/csv-trim.js" },
"scripts": {
  "test": "node --test test/",
  "example": "node bin/csv-trim.js examples/messy.csv"
},
"engines": { "node": ">=20" },
"license": "MIT"

Files: bin/csv-trim.js · test/trim.test.js · examples/messy.csv · LICENSE

Fictional sample project (csv-trim). Full files are in samples/input/.

OutputREADME.md

csv-trim

Trim whitespace from every cell of a CSV file and drop rows that are empty.

Requirements
  • Node.js 20 or later (engines in package.json). Tested here on 22.23.2.
  • No dependencies.
Setup
git clone <your-fork-url> csv-trim
cd csv-trim

The package is not on the npm registry, so the old npm install -g csv-trim line has been removed. To put csv-trim on your PATH from a checkout, run npm link (dry run only, not executed).

First run
npm run example

Expected output:

name,city
Ana,Porto
Bo,Oslo
Usage
node bin/csv-trim.js <input.csv>                     # print to stdout
node bin/csv-trim.js <input.csv> --out <output.csv>  # write a file

With no input file, it prints the usage line and exits with code 1.

Testing
node --test test/*.test.js

npm test (node --test test/) currently fails on Node.js 22: Node tries to load test/ as a module. Change the script to the command above to fix it.

Limitations
  • Not quote-aware: it splits on every comma, so the quoted field "Lisbon, PT" comes out as "Lisbon,PT" (checked).
  • Reads the whole file into memory.
License

MIT. See LICENSE.


Verification report
StepResult
npm run examplePassed. Output matches the block above.
node bin/csv-trim.js examples/messy.csv --out out.csvPassed. The file has the same three rows.
Run with no argumentsPassed. Prints usage, exit code 1.
node --test test/*.test.jsPassed (1 of 1).
npm testFailed: Cannot find module …/test.
npm linkNot run (dry run only).
Removed claims"fast", "production ready", "works everywhere": no evidence in the repository.

Produced by following readme-polish/SKILL.md on samples/input/ (Node.js 22.23.2, Linux). Fictional project.

SKILL.mdFull file · 20 lines
---
name: readme-polish
description: "Give your next project a README that gets people from curious to running."
---

# README, Reimagined

## When to use
Use this skill to create or improve a project's README using evidence from its actual source.

## Workflow
1. Inspect package manifests, scripts, licenses, existing docs, and application entry points. Never assume a stack or command.
2. Identify the intended reader and the shortest verified path from clone to a working result.
3. Organize the README into overview, requirements, setup, first run, common commands, configuration, testing, troubleshooting, and contributing when applicable.
4. Use exact commands from the repository. Mark external accounts and environment variables required, optional, or deferred. Include placeholder values only; never secrets.
5. Explain expected output after the first run. Include a small example only when it can be verified.
6. Validate links and execute safe documented commands where possible. Distinguish tested steps from unverified deployment instructions.

## Definition of done
A new developer can follow the README without hidden knowledge. No invented badges, benchmarks, licenses, compatibility promises, or success claims.
InstallClaude Code
npx skillbay install readme-polish --agent claude-code

Other agents and scopes: see Installation below.

WHAT IT WRITES

Every line traces back to the input.

A repeatable documentation workflow that starts with the actual project, verifies installation steps, and shapes a concise README around the reader's first successful run. No invented features, badges, or compatibility claims.

THE PLAYBOOK

How your agent works through it.

  1. 01
    Inspect manifests, scripts and docs
  2. 02
    Find the reader's shortest verified path
  3. 03
    Organise the README sections
  4. 04
    Use exact commands; mark env vars
  5. 05
    Explain the expected first-run output
  6. 06
    Validate links and commands; report
USE IT IN YOUR PROJECT

Choose your agent.

The package is instructions only: SKILL.md, a README and the sample run as Markdown, no scripts.

Native SKILL.mdOfficial docs reviewed · 2026-10-02
SKILL DIRECTORY
.claude/skills/readme-polish/

Review the package, then place the complete skill folder here. Keep SKILL.md, scripts, references and assets together.

IN YOUR AGENT/readme-polish
  1. Start a project session and inspect /skills; explicitly invoke /readme-polish.
LOCAL CLI INSTALL
npx skillbay install readme-polish --agent claude-code

Run from your target workspace. Requires Node.js 22 or later. Sign in once with npx skillbay login; premium packages install with an active plan. CLI docs

  • Local personal skills are not automatically present in Cowork or cloud sessions. Use repository skills in cloned cloud workspaces or separately enabled account skills.
  • Portable exports omit Claude-only dynamic shell interpolation and tool pre-approval.
Claude Code documentation
Filesystem install and export checks are separate from agent discovery or execution. Each workflow still needs its listed tools and dependencies. No end-to-end agent run is certified.
START WITH THIS REQUEST

Use the readme-polish skill. Read SKILL.md first. Ask me for anything it needs that I have not given you, follow its steps on my material, then report what you checked and anything you could not verify.

Related skills

Research Findings Report: sample outputPRO
🔒 Model info for members
AGENT WORKFLOWWriting

Research Findings Report

Turn a research package into a publishable findings report: ratings computed from cited sources, quotes checked word for word, withheld material kept private.

7 stages6 deliverablesPython 3.10+ (standard library only)
Claude CodeCodexGemini CLI
SKILL.md + scripts + referencesPreview only