Wip Readme Format

Reformat any repo's README to follow the WIP Computer standard.

wipcomputer cf2a389 4 files · 23.8 KB Updated

File contents

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

wipcomputer/wip-ai-devops-toolbox/tree/main/tools/wip-readme-format commit cf2a3897fd

Frequently asked questions

npx skillmds add wipcomputer-wip-ai-devops-toolbox/wip-readme-format