{"@context":"https://schema.org","@graph":[{"@type":"TechArticle","@id":"https://www.devtools.tools/ai/resource/readme-writer-prompt#article","headline":"README Writer","name":"README Writer","description":"A prompt for turning an existing project structure and usage notes into a concise, maintainable README.","url":"https://www.devtools.tools/ai/resource/readme-writer-prompt","dateModified":"2026-08-22","inLanguage":"en-US","isAccessibleForFree":true,"keywords":"documentation, readme, developer-experience","license":"MIT","author":[{"@type":"Person","name":"Community contributors"}],"isPartOf":{"@type":"WebSite","@id":"https://www.devtools.tools#website","name":"DevTools"},"about":{"@type":"Thing","name":"PROMPT"},"sameAs":"https://github.com/f/awesome-chatgpt-prompts"},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"DevTools","item":"https://www.devtools.tools"},{"@type":"ListItem","position":2,"name":"AI Community Hub","item":"https://www.devtools.tools/ai"},{"@type":"ListItem","position":3,"name":"PROMPT resources","item":"https://www.devtools.tools/ai/prompts"},{"@type":"ListItem","position":4,"name":"README Writer","item":"https://www.devtools.tools/ai/resource/readme-writer-prompt"}]}]}
PromptMIT
README Writer
A prompt for turning an existing project structure and usage notes into a concise, maintainable README.
View source Source Reviewed
Prompt template
Write a README for the project described below. Preserve facts, call out unknowns instead of inventing them, and include setup, scripts, configuration, and troubleshooting sections.
Project notes:
{{PROJECT_NOTES}}Input and output
Input: Plain text project notes or a sanitized repository summary.
Output: Markdown README with factual sections and runnable commands.
Examples
Input: A TypeScript CLI with `pnpm install`, `pnpm build`, and `pnpm test`.
Output: A README with prerequisites, installation, command reference, configuration, and test instructions.
Security notes
Do not include private environment variables, credentials, or internal URLs in the input.