Mmk Skills

Automate Magic Meal Kits CLI operations with a collection of powerful agent skills.

<p align="center"> <img src="assets/banner.png" alt="Magic Meal Kits — automate the impossible" width="700"> </p>

[!WARNING] This project is in beta. Skills, command signatures, and installation methods may change without notice.

MMK Skills

Agent skills for automating Magic Meal Kits CLI operations. Covers Notion, Paymint, Threads, and YouTube. Works with Claude Code, Gemini CLI, OpenCode, Codex, Cursor, and 38+ agents.

Getting Started

1. Install the MMK CLI

npm install -g @magic-meal-kits/cli@beta
mmk config set server <your-server-url>
mmk auth login

2. Install Skills

Gemini CLI

Install the extension into the Gemini CLI:

gemini extensions install https://github.com/magic-meal-kits/mmk-skills

Installing this extension gives your Gemini CLI agent direct access to all mmk commands and Magic Meal Kits agent skills. Because mmk handles its own authentication, you simply need to authenticate your terminal once (Step 1) and the extension will automatically inherit your credentials.

Claude Code / OpenCode / Codex / Cursor

npx skills add https://github.com/magic-meal-kits/mmk-skills
<details> <summary>More install options (by service, individual sub-commands, plugin marketplace)</summary>
# Install by service (root + all sub-commands)
npx skills add https://github.com/magic-meal-kits/mmk-skills/tree/main/skills/mmk-notion
npx skills add https://github.com/magic-meal-kits/mmk-skills/tree/main/skills/mmk-paymint
npx skills add https://github.com/magic-meal-kits/mmk-skills/tree/main/skills/mmk-threads
npx skills add https://github.com/magic-meal-kits/mmk-skills/tree/main/skills/mmk-youtube

# Or install individual sub-commands only
npx skills add https://github.com/magic-meal-kits/mmk-skills/tree/main/skills/mmk-notion-page
npx skills add https://github.com/magic-meal-kits/mmk-skills/tree/main/skills/mmk-paymint-send
npx skills add https://github.com/magic-meal-kits/mmk-skills/tree/main/skills/mmk-threads-posts
npx skills add https://github.com/magic-meal-kits/mmk-skills/tree/main/skills/mmk-youtube-transcript
# Or install via plugin marketplace
/plugin marketplace add magic-meal-kits/mmk-skills
/plugin install mmk-skills@mmk-plugins
</details>

3. Use

Type / in Claude Code to see available skills:

/mmk-notion             — Notion commands overview (links to sub-commands)
/mmk-notion-page        — Page invite, revoke, publish, config, duplicate, markdown, transcript, get, update, update-markdown (13 commands)
/mmk-notion-workspace   — Workspace invite and remove (2 commands)
/mmk-notion-team        — Team list, invite, remove (3 commands)
/mmk-notion-subscription — Subscription details (1 command)
/mmk-notion-people      — List members/guests, guest pages (2 commands)
/mmk-notion-database    — Schema, query, insert, update, upsert, delete, AI summary, AI summary auto (8 commands)
/mmk-notion-comment     — Page comments: add, list, reply (3 commands)
/mmk-notion-user        — User details, list workspace users (2 commands)
/mmk-notion-meeting     — AI meeting notes (1 command)
/mmk-notion-emoji       — Custom workspace emojis (1 command)
/mmk-notion-view        — Database views: list, get, create, update, delete (5 commands)
/mmk-paymint            — Paymint overview + license resolution + errors
/mmk-paymint-licenses   — List licenses
/mmk-paymint-send       — Send invoice
/mmk-paymint-status     — Check invoice status
/mmk-paymint-cancel     — Cancel/refund invoice
/mmk-paymint-resend     — Resend invoice SMS
/mmk-paymint-bulk-send  — Bulk send invoices
/mmk-paymint-bulk-resend — Bulk resend SMS
/mmk-threads            — Threads overview + pagination
/mmk-threads-posts      — Get recent posts
/mmk-threads-insights   — Account analytics
/mmk-threads-replies    — Post replies/conversation
/mmk-youtube            — YouTube overview + positional arg note
/mmk-youtube-metadata   — Video metadata
/mmk-youtube-videotype  — Video vs Short
/mmk-youtube-transcript — Video transcript
/mmk-notion-onboard     — Invite to Notion with Gmail fallback (recipe)
/mmk-notion-database-ai-summary — Bulk AI summary across database pages (recipe)
/mmk-notion-meeting-comment — Post structured meeting summary as page comment (recipe)
/mmk-paymint-notion-schema  — Recommended Notion DB schema for Paymint invoices
/mmk-paymint-notion-invoice — Batch send Paymint invoices from Notion database (recipe)
/mmk-youtube-channel-summary — Summarize YouTube channel videos into Notion database (recipe)

Skill Inventory

SkillTypeTriggerCommands
mmk-sharedBackgroundAuto-loadedFoundation: auth, flags, errors
Notion
mmk-notionRoot/mmk-notionOverview + sub-command links (41 commands total)
mmk-notion-pageSub-command/mmk-notion-pageinvite, revoke, publish, unpublish, config, publish-settings, duplicate, list-published, markdown, transcript, get, update, update-markdown
mmk-notion-workspaceSub-command/mmk-notion-workspaceinvite, remove
mmk-notion-teamSub-command/mmk-notion-teamlist, invite, remove
mmk-notion-subscriptionSub-command/mmk-notion-subscriptionsubscription
mmk-notion-peopleSub-command/mmk-notion-peoplelist, guest-pages
mmk-notion-databaseSub-command/mmk-notion-databaseschema, query, insert, update, upsert, delete, ai-summary, ai-summary-auto
mmk-notion-commentSub-command/mmk-notion-commentadd, list, reply
mmk-notion-userSub-command/mmk-notion-userget, list
mmk-notion-meetingSub-command/mmk-notion-meetinglist
mmk-notion-emojiSub-command/mmk-notion-emojilist
mmk-notion-viewSub-command/mmk-notion-viewlist, get, create, update, delete
Paymint
mmk-paymintRoot/mmk-paymintOverview + license resolution + errors (7 commands total)
mmk-paymint-licensesSub-command/mmk-paymint-licenseslicenses
mmk-paymint-sendSub-command/mmk-paymint-sendsend
mmk-paymint-statusSub-command/mmk-paymint-statusstatus
mmk-paymint-cancelSub-command/mmk-paymint-cancelcancel
mmk-paymint-resendSub-command/mmk-paymint-resendresend
mmk-paymint-bulk-sendSub-command/mmk-paymint-bulk-sendbulk-send
mmk-paymint-bulk-resendSub-command/mmk-paymint-bulk-resendbulk-resend
Threads
mmk-threadsRoot/mmk-threadsOverview + pagination (3 commands total)
mmk-threads-postsSub-command/mmk-threads-postsposts
mmk-threads-insightsSub-command/mmk-threads-insightsinsights
mmk-threads-repliesSub-command/mmk-threads-repliesreplies
YouTube
mmk-youtubeRoot/mmk-youtubeOverview + positional arg note (3 commands total)
mmk-youtube-metadataSub-command/mmk-youtube-metadatametadata
mmk-youtube-videotypeSub-command/mmk-youtube-videotypevideotype
mmk-youtube-transcriptSub-command/mmk-youtube-transcripttranscript
Recipes
mmk-notion-onboardRecipeManual onlyMulti-step: Notion invite + Gmail signup fallback
mmk-notion-database-ai-summaryRecipeManual onlyMulti-step: Discover AI config + batch summary generation
mmk-notion-meeting-commentRecipeManual onlyMulti-step: Meeting transcript + structured comment
mmk-paymint-notion-schemaReference/mmk-paymint-notion-schemaRecommended Notion DB schema for Paymint invoices
mmk-paymint-notion-invoiceRecipeManual onlyMulti-step: Notion DB query + batch Paymint invoice send
mmk-youtube-channel-summaryRecipeManual onlyMulti-step: RSS fetch + filter Shorts + metadata/transcript + AI summary + Notion upsert

Architecture

mmk-shared (background)              <- Foundation: auth, flags, errors
├── mmk-notion (root)                <- Overview + tips (41 commands)
│   ├── mmk-notion-page              <- 13 page commands
│   ├── mmk-notion-workspace         <- 2 workspace commands
│   ├── mmk-notion-team              <- 3 team commands
│   ├── mmk-notion-subscription      <- 1 subscription command
│   ├── mmk-notion-people            <- 2 people commands
│   ├── mmk-notion-database          <- 8 database commands
│   ├── mmk-notion-comment           <- 3 comment commands
│   ├── mmk-notion-user              <- 2 user commands
│   ├── mmk-notion-meeting           <- 1 meeting command
│   ├── mmk-notion-emoji             <- 1 emoji command
│   └── mmk-notion-view              <- 5 view commands
├── mmk-paymint (root)               <- Overview + license resolution + errors (7 commands)
│   ├── mmk-paymint-licenses         <- List licenses
│   ├── mmk-paymint-send             <- Send invoice
│   ├── mmk-paymint-status           <- Check status
│   ├── mmk-paymint-cancel           <- Cancel/refund
│   ├── mmk-paymint-resend           <- Resend SMS
│   ├── mmk-paymint-bulk-send        <- Bulk send invoices
│   └── mmk-paymint-bulk-resend      <- Bulk resend SMS
├── mmk-threads (root)               <- Overview + pagination (3 commands)
│   ├── mmk-threads-posts            <- Get posts
│   ├── mmk-threads-insights         <- Account analytics
│   └── mmk-threads-replies          <- Post replies
├── mmk-youtube (root)               <- Overview + positional args (3 commands)
│   ├── mmk-youtube-metadata         <- Video metadata
│   ├── mmk-youtube-videotype        <- Video vs Short
│   └── mmk-youtube-transcript       <- Video transcript
├── mmk-notion-onboard (recipe)      <- Notion invite + Gmail fallback
├── mmk-notion-database-ai-summary (recipe) <- Bulk AI summary for database
├── mmk-notion-meeting-comment (recipe) <- Meeting transcript + summary comment
├── mmk-paymint-notion-schema (reference) <- Recommended Notion DB schema for invoices
├── mmk-paymint-notion-invoice (recipe) <- Batch invoice from Notion DB
└── mmk-youtube-channel-summary (recipe) <- YouTube channel summary to Notion
  • Background skills load automatically when relevant context is detected
  • Root skills provide overview, shared guidance, and links to sub-command skills
  • Sub-command skills are independently installable and contain focused command docs
  • Recipe skills require manual invocation (disable-model-invocation: true) because they have side effects

Usage Examples

Notion: Invite a user to a page

/mmk-notion-page
> Invite [email protected] as editor to https://notion.so/my-page-abc123

Paymint: Send an invoice

/mmk-paymint-send
> Send a 50,000 KRW invoice to 01012345678 for "Workshop Fee", name "Kim", message "March workshop", expiring 2026-04-01

Threads: Check recent posts with engagement

/mmk-threads-posts
> Show my last 10 posts with engagement metrics

Paymint: Batch invoices from Notion

/mmk-paymint-notion-invoice
> Send invoices from database abc123-def456

YouTube: Get a transcript

/mmk-youtube-transcript
> Get the transcript for https://youtube.com/watch?v=abc123

YouTube: Summarize channel videos to Notion

/mmk-youtube-channel-summary
> Channels: UC_x5XG1OV2P6uZZ5FSM9Ttw, UCddiUEpeqJcYeBxX1IVBKvQ
> Database: abc123-def456, last 7 days

Compatibility

These skills work with Claude Code, Gemini CLI, OpenCode, Codex, Cursor, and 38+ agents. They also work alongside GWS Skills (Google Workspace CLI). The mmk-notion-onboard skill composes both mmk and gws commands.

Requirements

  • Claude Code CLI
  • MMK CLI (npm install -g @magic-meal-kits/cli@beta)
  • Active MMK server endpoint