skills/readme-generator/SKILL.md
Auto-generate a README.md with product overview, tech stack, setup instructions, and architecture. Use when the user needs a README for their startup repository, wants to document the project for new developers, or needs to keep the README in sync with the actual project state.
npx skillsauth add Cheggin/skill-chain readme-generatorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Auto-generate a README.md that stays in sync with the project state. Includes what the product does, the tech stack, how to set up the dev environment, an architecture overview, and how to contribute.
Read the product spec to write a plain-language description of what the product does and who it is for. Keep it to two or three sentences.
Read project configuration files (package.json, stacks.yml, etc.) to list the tech stack and major dependencies with version numbers and links:
## Tech Stack
- [Next.js 15](https://nextjs.org) - React framework
- [Convex](https://convex.dev) - Backend and database
- [Tailwind CSS 4](https://tailwindcss.com) - Styling
- [Clerk](https://clerk.com) - Authentication
Derive step-by-step local dev setup instructions from the actual project setup process:
## Getting Started
1. Clone the repository: `git clone <url>`
2. Install dependencies: `pnpm install`
3. Copy environment variables: `cp .env.example .env.local`
4. Start the dev server: `pnpm dev`
Describe the high-level system design: how the frontend, backend, database, and external services connect. Include a project structure section explaining key directories and their purpose.
Summarize how agents and humans contribute. Link to CONTRIBUTING.md if it exists.
Generate badges for build status, deploy status, and test coverage. Link to the documentation site if the documentation-generator skill is active.
Check the README against the actual project state to ensure no stale references (removed scripts, outdated versions, renamed directories). Configure regeneration so the README updates when features are added or the stack changes.
development
Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, typography, micro-interactions, enter/exit animations, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, font smoothing, tabular numbers, image outlines, box shadows.
documentation
Agentic memory system for writers - track characters, relationships, scenes, and themes
documentation
LLM Wiki — persistent markdown knowledge base that compounds across sessions (Karpathy model)
development
Build production-quality SaaS websites with opinionated design presets. Use when creating any startup website. The user MUST pick a design style before building. Enforces shadcn/ui, Figma design principles, specific CSS values per style, and anti-AI-writing. Load alongside anti-ai-writing skill. LIGHT MODE ONLY.