README Formatter
Reformats a repo's README to follow the WIP Computer standard. Agent-first, human-readable.
Commands
wip-readme-format /path/to/repo # rewrite README.md
wip-readme-format /path/to/repo --dry-run # preview without writing
wip-readme-format /path/to/repo --check # validate, exit 0/1
What happens
- Detects all interfaces (CLI, Module, MCP, OC Plugin, Skill, CC Hook)
- Reads package.json for name, description, repo URL
- Reads SKILL.md for features
- Generates the README following the standard:
- WIP Computer header + interface badges
- Title + tagline
- "Teach Your AI" onboarding block
- Features list
- Interface coverage table (toolbox repos only)
- More Info links
- License block
- Moves technical content to TECHNICAL.md (never deleted)
The standard
[badges]
# Tool Name
Tagline.
## Teach Your AI to [verb]
[onboarding prompt block]
## Features
[feature list]
## Interface Coverage (toolbox only)
[auto-generated table]
## More Info
- Technical Documentation ... link
- Universal Interface Spec ... link
## License
[standard block]
Interfaces
CLI, Skill