docs: rebuild README and skill — add file commands, subtitles, fine-grained sizing

[Franzferdinan51]

Changes

README.md:

• Added commands section (upload, list, delete)
• Added example
• Added and examples
• Added and commands
• Updated Quick Start with file management examples

skill/SKILL.md:

• Added all three subcommands (upload, list, delete) with full flag tables
• Added flag to speech section
• Added , , , , to image section
• Added single-token shorthand section for quick commands
• Updated default config section with per-modality keys
• Separated from {
  "model_remains": [
  {
  "start_time": 1779926400000,
  "end_time": 1779944400000,
  "remains_time": 7775178,
  "current_interval_total_count": 4500,
  "current_interval_usage_count": 2774,
  "model_name": "MiniMax-M*",
  "current_weekly_total_count": 0,
  "current_weekly_usage_count": 0,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335375178
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76175161,
  "current_interval_total_count": 4000,
  "current_interval_usage_count": 4000,
  "model_name": "speech-hd",
  "current_weekly_total_count": 28000,
  "current_weekly_usage_count": 28000,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335375161
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76175146,
  "current_interval_total_count": 0,
  "current_interval_usage_count": 0,
  "model_name": "MiniMax-Hailuo-2.3-Fast-6s-768p",
  "current_weekly_total_count": 0,
  "current_weekly_usage_count": 0,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335375146
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76175132,
  "current_interval_total_count": 0,
  "current_interval_usage_count": 0,
  "model_name": "MiniMax-Hailuo-2.3-6s-768p",
  "current_weekly_total_count": 0,
  "current_weekly_usage_count": 0,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335375132
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76175115,
  "current_interval_total_count": 0,
  "current_interval_usage_count": 0,
  "model_name": "music-2.5",
  "current_weekly_total_count": 0,
  "current_weekly_usage_count": 0,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335375115
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76175100,
  "current_interval_total_count": 100,
  "current_interval_usage_count": 100,
  "model_name": "music-2.6",
  "current_weekly_total_count": 700,
  "current_weekly_usage_count": 700,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335375100
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76175072,
  "current_interval_total_count": 100,
  "current_interval_usage_count": 100,
  "model_name": "music-cover",
  "current_weekly_total_count": 700,
  "current_weekly_usage_count": 700,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335375072
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76175056,
  "current_interval_total_count": 100,
  "current_interval_usage_count": 100,
  "model_name": "lyrics_generation",
  "current_weekly_total_count": 700,
  "current_weekly_usage_count": 700,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335375056
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76175042,
  "current_interval_total_count": 50,
  "current_interval_usage_count": 50,
  "model_name": "image-01",
  "current_weekly_total_count": 350,
  "current_weekly_usage_count": 350,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335375042
  },
  {
  "start_time": 1779926400000,
  "end_time": 1779944400000,
  "remains_time": 7775025,
  "current_interval_total_count": 4500,
  "current_interval_usage_count": 2774,
  "model_name": "coding-plan-vlm",
  "current_weekly_total_count": 0,
  "current_weekly_usage_count": 0,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335375025
  },
  {
  "start_time": 1779926400000,
  "end_time": 1779944400000,
  "remains_time": 7775008,
  "current_interval_total_count": 4500,
  "current_interval_usage_count": 2774,
  "model_name": "coding-plan-search",
  "current_weekly_total_count": 0,
  "current_weekly_usage_count": 0,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335375008
  }
  ],
  "category_remains": [
  {
  "start_time": 1779926400000,
  "end_time": 1779944400000,
  "remains_time": 7775001,
  "current_interval_total_count": 4500,
  "current_interval_usage_count": 2774,
  "current_weekly_total_count": 0,
  "current_weekly_usage_count": 0,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335375001,
  "category": "text_generation",
  "display_name": "Text Generation"
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76174987,
  "current_interval_total_count": 4000,
  "current_interval_usage_count": 4000,
  "current_weekly_total_count": 28000,
  "current_weekly_usage_count": 28000,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335374987,
  "category": "speech_generation",
  "display_name": "Speech Generation"
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76174984,
  "current_interval_total_count": 100,
  "current_interval_usage_count": 100,
  "current_weekly_total_count": 700,
  "current_weekly_usage_count": 700,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335374984,
  "category": "lyrics_generation",
  "display_name": "Lyrics Generation"
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76174981,
  "current_interval_total_count": 0,
  "current_interval_usage_count": 0,
  "current_weekly_total_count": 0,
  "current_weekly_usage_count": 0,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335374981,
  "category": "video_generation",
  "display_name": "Video Generation"
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76174978,
  "current_interval_total_count": 0,
  "current_interval_usage_count": 0,
  "current_weekly_total_count": 0,
  "current_weekly_usage_count": 0,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335374978,
  "category": "video_fast_generation",
  "display_name": "Video Fast Generation"
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76174975,
  "current_interval_total_count": 50,
  "current_interval_usage_count": 50,
  "current_weekly_total_count": 350,
  "current_weekly_usage_count": 350,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335374975,
  "category": "image_generation",
  "display_name": "Image Generation"
  },
  {
  "start_time": 1779926400000,
  "end_time": 1780012800000,
  "remains_time": 76174971,
  "current_interval_total_count": 100,
  "current_interval_usage_count": 100,
  "current_weekly_total_count": 700,
  "current_weekly_usage_count": 700,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335374971,
  "category": "music_generation",
  "display_name": "Music Generation"
  },
  {
  "start_time": 1779926400000,
  "end_time": 1779944400000,
  "remains_time": 7774968,
  "current_interval_total_count": 4500,
  "current_interval_usage_count": 2774,
  "current_weekly_total_count": 0,
  "current_weekly_usage_count": 0,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335374968,
  "category": "coding-plan-vlm",
  "display_name": "MCP Understand Image"
  },
  {
  "start_time": 1779926400000,
  "end_time": 1779944400000,
  "remains_time": 7774965,
  "current_interval_total_count": 4500,
  "current_interval_usage_count": 2774,
  "current_weekly_total_count": 0,
  "current_weekly_usage_count": 0,
  "weekly_start_time": 1779667200000,
  "weekly_end_time": 1780272000000,
  "weekly_remains_time": 335374965,
  "category": "coding-plan-search",
  "display_name": "MCP Web Search"
  }
  ],
  "base_resp": {
  "status_code": 0,
  "status_msg": "success"
  }
  }
• Added
  �[38;5;250m███████╗██╗ ██╗██╗██╗ ██╗ ███████╗�[0m
  �[38;5;248m██╔════╝██║ ██╔╝██║██║ ██║ ██╔════╝�[0m
  �[38;5;245m███████╗█████╔╝ ██║██║ ██║ ███████╗�[0m
  �[38;5;243m╚════██║██╔═██╗ ██║██║ ██║ ╚════██║�[0m
  �[38;5;240m███████║██║ ██╗██║███████╗███████╗███████║�[0m
  �[38;5;238m╚══════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝╚══════╝�[0m

ERROR Missing required argument: source

Usage:
npx skills add [options]

Example:
npx skills add vercel-labs/agent-skills in quick install section

Credentials are stored separately from OpenClaw's MMX auth. Skill built from live source at src/commands/. Already reflects the latest version of the mmx-cli source.

[TumCucTom]

this fills real gaps — file commands, single-token shorthand, and the auth --recommend flow. nice.

two things:

the PR body has a raw /v1/coding_plan/quotas API response, a npx skills add error screenshot, and several unfilled {{...}} placeholders. worth a cleanup pass before merge — a clean bullet list of what changed and why, the same shape as the README/SKILL.md diffs.

the README addition under mmx config documents mmx quotas as a shorthand for the per-modality breakdown. the actual command is mmx quota (subcommand show) and there's no quotas alias, so the example will throw on a clean install. either drop the line or add the alias as part of this PR.

rest of the new examples check out.

[RyanLee-Dev]

Closing this stale docs rebuild PR. It now conflicts with main and the README/skill docs have moved through several follow-up changes since this branch was created. Any remaining doc gaps should be reopened as a fresh, narrow PR against current main.