AI Readme
Create or substantially revise repository README files that help a specific reader understand a technical project, reach a verified first result, and progress into realistic use, evaluation, debugging, or contribution. Use for project landing READMEs, CLI and library quickstarts, experimental or research repositories, executable engineering notebooks, and contributor-facing repository guides when an agent should reconstruct behavior from code, tests, commands, examples, and history rather than write generic documentation.
Install
npx skills add swyxio/skills --skill ai-readmegit clone --depth 1 https://github.com/swyxio/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/ai-readme ~/.claude/skills/ai-readmePersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# AI README Write a repository-native explanation that earns trust by working. Lead with what the project is, who it helps, and the shortest verified path to an observable result. Then reveal the mechanism, tradeoffs, diagnostics, and internals at the reader's pace. Combine two complementary habits: - use an executable, progressive spine: one stable example, working commands, expected results, controlled variants, visible failure modes, and a reference path when correctness or quality can vary; - write like a public technical notebook: begin from a real task or curiosity, show the decisive artifact near the claim, explain what happened in ordinary language, preserve surprise and uncertainty, and stop when the reader's job is complete. Apply `swyx-writing` as the shared voice and editing layer. For substantial public README work, read its [technical-writer influences](../swyx-writing/references/technical-writer-influences.md). Apply `research-grounded-writing` when external claims or comparisons need support beyond the repository. ## Choose the README's job Identify the primary job before choosing sections: - **Project landing page:** help a newcomer understand, evaluate, and try the project. - **CLI or library guide:** get an adopter from installation to one useful call, then document common recipes, errors, and the deeper reference. - **Experiment or research repository:** state the question, setup, runnable
Details
- Skill name
ai-readme- Repository
- swyxio/skills
- Path
ai-readme/SKILL.md- License
- MIT
- Repo updated
- 16 November 2026
FAQ
What does the AI Readme skill do?
Create or substantially revise repository README files that help a specific reader understand a technical project, reach a verified first result, and progress into realistic use, evaluation, debugging, or contribution. Use for project landing READMEs, CLI and library quickstarts, experimental or research repositories, executable engineering notebooks, and contributor-facing repository guides when an agent should reconstruct behavior from code, tests, commands, examples, and history rather than write generic documentation.
How do I install the AI Readme skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add swyxio/skills --skill ai-readme. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is AI Readme popular?
It lives in swyxio/skills, which has 201 GitHub stars and 12 forks.
Related skills
Accelevents API
201swyxio/skills
Use when reading or updating AI Engineer Europe speaker records through the Accelevents REST API, especially for full-record PUT updates, auth header quirks, and preserving existing speaker fields.
Accelevents Speaker Sync
201swyxio/skills
Use when website speaker, session, schedule, room, track, or headshot changes must be synchronized back to Accelevents for AI Engineer Europe 2026.
Agents SDK
201swyxio/skills
Build or debug stateful applications that specifically use Cloudflare's `agents` package, including Agent classes, routing, callable methods, synchronized state, scheduling, AIChatAgent, durable execution, or Agents SDK client hooks. Do not trigger for generic AI-agent design, the OpenAI Agents SDK, or ordinary Durable Object work that does not use the Cloudflare Agents SDK.
AI Storyboard 2x2
150guia-matthieu/clawfu-skills
Créez des storyboards visuellement cohérents en utilisant la technique des 2x2 Grid Shots de PJ Ace, garantissant éclairage, personnages et décors uniformes entre les plans. Use when: **Après avoir finalisé un script vidéo** - Transformer le concept en visuels; **Besoin de cohérence visuelle** - Personnages et éclairage constants entre les plans; **Préparer des assets pour animation** - Frames prêtes pour Veo, Runway, Kling; **Présenter un storyboard client** - Visualisation avant production;...
Work Order Writeup
110microsoft/cat-agent-skills
Renders one fixed-layout cited Markdown work-order draft for technician/planner review. Use for "draft technician notes", "write up this work order", "give the planner summary", or "show the proposed next action". No audience-switching or document-conversion feature. Do NOT use for intake — use wo-intake; retrieval — use knowledge-retrieve; ranking — use similar-work-rank; stock checks — use parts-readiness. No CMMS write-back, closure, scheduling or purchasing, even when approved.
Blind Spot Detective
191jwynia/agent-skills
Systematically identify what's missing in non-fiction writing—both blind spots (inherent limitations) and blank spots (gaps that could be addressed). Use before finalizing non-fiction or when feedback feels incomplete.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.