mmk-sharedlisted
Install: claude install-skill magic-meal-kits/mmk-skills
# MMK CLI — Shared Foundation
Background knowledge for all skills that use the `mmk` CLI.
## Prerequisites
The `mmk` CLI must be installed and configured:
```bash
# Install
npm install -g @magic-meal-kits/cli@beta
# Configure server endpoint
mmk config set server <server-url>
# Authenticate
mmk auth login
```
## Global Flags
| Flag | Short | Default | Purpose |
|------|-------|---------|---------|
| `--output` | `-o` | `table` | Output format: `table` or `json` |
| `--server` | | (from config) | Override server URL |
| `--config` | | `~/.config/mmk/config.yaml` | Override config file |
**Critical for skill composition**: Always use `-o json` when composing multiple commands or parsing output programmatically. Table output is for human display only.
## Error Format
When a command fails, the CLI outputs to stderr:
```
✗ HTTP <status_code>
<error message>
```
With `-o json`, errors are returned as:
```json
{"error": "<error message>"}
```
The error message comes from the server's JSON response `{"error": "..."}` field. The CLI exits with a non-zero status code on failure.
### Common Error Patterns
| Error | Meaning | Action |
|-------|---------|--------|
| `"not authenticated"` or auth failure | Token expired or not logged in | Run `mmk auth login` |
| `"request failed with status 400"` | Bad request (missing/invalid params) | Check required flags |
| `"request failed with status 403"` | Forbidden | Check permissions |
| `"request failed with status 404"` | Res