Reformat any repo's README to follow the WIP Computer standard.
---
name: wip-readme-format
description: Reformat any repo's README to follow the WIP Computer standard.
license: MIT
interface: [cli, skill]
metadata:
display-name: "README Formatter"
version: "1.0.0"
homepage: "https://github.com/wipcomputer/wip-ai-devops-toolbox"
author: "Parker Todd Brooks"
category: repo-management
capabilities:
- readme-generation
- readme-validation
- section-staging
requires:
bins: [node]
openclaw:
requires:
bins: [node]
install:
- id: node
kind: node
package: "@wipcomputer/wip-readme-format"
bins: [wip-readme-format]
label: "Install via npm"
emoji: "📝"
compatibility: Requires node. Node.js 18+.
---
# 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
1. Detects all interfaces (CLI, Module, MCP, OC Plugin, Skill, CC Hook)
2. Reads package.json for name, description, repo URL
3. Reads SKILL.md for features
4. 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
5. 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
don't have the plugin yet? install it then click "run inline in claude" again.