update-readme
Updates README.md to match the current project state. Use when the user says "update readme", "sync readme", "refresh documentation", "readme is outdated", or asks to document the project.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Update README
Analyze a project's codebase and update its README.md to accurately reflect the current state.
Instructions
- Read the current
README.mdto understand existing structure - Read package files (
package.json,Cargo.toml,pyproject.toml,go.mod, etc.) for metadata - Use Glob to understand directory layout (
**/*.{js,ts,py,go,rs}) - Compare README against actual codebase for discrepancies
- Update only sections that are outdated or incorrect
- Provide a summary of changes made
What to verify
- Dependencies: Match actual package files
- Features: Reflect capabilities found in code
- Installation: Steps work with current setup
- Usage examples: Code snippets are accurate
- File references: Mentioned paths exist
- Configuration: Options are complete
Rules
- MUST preserve existing README structure when possible
- MUST keep any badges, images, or custom formatting
- MUST use relative links for internal documentation
- Never add sections that weren't requested
- Never remove sections without explicit approval
- Never fabricate features not found in the codebase
Output
After updating, summarize:
- Sections updated
- What was added or removed
- Anything needing manual review
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!