Agent skill

Pp Midjourney

by mvanhorn in mvanhorn/printing-press-library

Inspect Midjourney jobs, queue, folders, and discovery feeds from the terminal

Apache-2.0Auto-check: notesMedia & Creative

Install Pp Midjourney

skills CLI
$ npx skills add mvanhorn/printing-press-library --skill pp-midjourney -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mvanhorn/printing-press-library pp-midjourney --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .claude/skills && cp -r skills-src/library/ai/midjourney .claude/skills/pp-midjourney && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pp-midjourney
GitHub stars
2.1k
Token cost
~2.4k tokens
SKILL.md length
1,032 words
Files
116
Skills in repo
506
Repo updated
First seen
Licence
Apache-2.0

At a glance

Inspect Midjourney jobs, queue, folders, and discovery feeds from the terminal

  • Works in 3 steps: Install via the Printing Press… → Verify: midjourney-pp-cli --version → Ensure the reported install directory is…
  • Media & Creative work in your project
  • SKILL.md covers Prerequisites: Install the CLI, When Not to Use This CLI, HTTP Transport and Discovery Signals, plus 10 more sections
  • Calls go, claude and npx

What it does

Pp Midjourney is an agent skill from mvanhorn/printing-press-library. Inspect Midjourney jobs, queue, folders, and discovery feeds from the terminal

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 120 other files (for example `.golangci.yml`, `.goreleaser.yaml` and `.manuscripts/20260523-212652/proofs/phase5-acceptance.json`).

It sits in Media & Creative. It works with Midjourney. The repository describes itself as: Official library of CLIs generated by the CLI Printing Press. Endorsed, tested, and community-contributed. The licence is Apache-2.0.

When your agent uses it

  • Media & Creative work in your project

Example prompts

  • “/pp-midjourney”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): Read, Bash

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and…
  2. Verify: midjourney-pp-cli --version
  3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

What it can do on your machine

Read from SKILL.md and the folder at commit d9a1696. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • go
    • claude
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pp Midjourney loads about 2.4k tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 1,032 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mvanhorn/printing-press-library at commit d9a1696, republished under its Apache-2.0 licence (© mvanhorn). 1,032 words, ~2,428 tokens.

Download SKILL.mdSave it as .claude/skills/pp-midjourney/SKILL.md (or your agent's skills folder). This skill also uses 115 other files; get the full folder from GitHub.
name
pp-midjourney
description
Inspect Midjourney jobs, queue, folders, and discovery feeds from the terminal
allowed-tools
Read, Bash
author
Dave Fano
license
Apache-2.0
argument-hint
<command> [args] | install cli|mcp

Midjourney — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the midjourney-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

  1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:
    bash
    npx -y @mvanhorn/printing-press-library install midjourney --cli-only
  2. Verify: midjourney-pp-cli --version
  3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

bash
go install github.com/mvanhorn/printing-press-library/library/ai/midjourney/cmd/midjourney-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When Not to Use This CLI

Most generated endpoint commands are read-only inspection commands. Do not use mutating commands unless the user explicitly asks to submit Midjourney work. In particular, imagine and rerun create remote Midjourney jobs, and download writes a local file.

HTTP Transport

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.

Discovery Signals

This CLI was generated with browser-observed traffic context.

  • Capture coverage: 62 API entries from 62 total network entries
  • Protocols: rest_json (75% confidence)
  • Generation hints: browser_http_transport, requires_protected_client
  • Candidate command ideas: list_contests_ranking_count — Derived from observed GET /api/contests-ranking-count traffic.; list_editor_sessions_sync — Derived from observed GET /api/editor-sessions-sync traffic.; list_explore — Derived from observed GET /api/explore traffic.; list_explore_styles_likes — Derived from observed GET /api/explore-styles-likes traffic.; list_folders — Derived from observed GET /api/folders traffic.; list_following_for_user — Derived from observed GET /api/following-for-user traffic.; list_get_user_country — Derived from observed GET /api/get-user-country traffic.; list_imagine — Derived from observed GET /api/imagine traffic.

Command Reference

explore — Browse Midjourney explore feeds

  • midjourney-pp-cli explore list — Fetch an explore feed
  • midjourney-pp-cli explore style-likes — Fetch style-like metadata for explore cards

folders — Inspect Midjourney organize folders

  • midjourney-pp-cli folders — List folders in the authenticated account

generations — Inspect generated Midjourney jobs and image history

  • midjourney-pp-cli generations list — List recent jobs/images for the authenticated Midjourney user
  • midjourney-pp-cli generations updates — Poll recent job updates for the authenticated user

moodboards — Inspect Midjourney moodboards

  • midjourney-pp-cli moodboards — List moodboards for the authenticated account

profiles — Inspect personalization/profile metadata

  • midjourney-pp-cli profiles following — List following metadata for the logged-in user
  • midjourney-pp-cli profiles personalized — List personalized profile metadata

queue — Inspect the current Midjourney generation queue

  • midjourney-pp-cli queue — Show queued/running Midjourney work for the logged-in account

rankings — Inspect ranking and rating surfaces

  • midjourney-pp-cli rankings contests-count — Fetch contest ranking counts
  • midjourney-pp-cli rankings model-ratings — Fetch model rating tasks visible to the account

storage — Inspect Midjourney account storage metadata

  • midjourney-pp-cli storage — List storage metadata exposed by the web app
Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

bash
midjourney-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Auth Setup

Run midjourney-pp-cli auth setup to print the URL and steps for getting a key (add --launch to open the URL). Then set:

bash
export MIDJOURNEY_COOKIE_HEADER="<your-key>"

Or persist it in ``.

Run midjourney-pp-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

  • Pipeable — JSON on stdout, errors on stderr

  • Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:

    bash
    midjourney-pp-cli explore list --agent --select id,name,status
  • Previewable — --dry-run shows the request without sending

  • Offline-friendly — sync/search commands can use the local SQLite store when available

  • Non-interactive — never prompts, every input is a flag

  • Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests

Show full SKILL.md (430 more words)Show less
Response envelope

Commands that read from the local store or the API wrap output in a provenance envelope:

json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal AND no machine-format flag (--json, --csv, --compact, --quiet, --plain, --select) is set — piped/agent consumers and explicit-format runs get pure JSON on stdout.

Agent Feedback

When you (or the agent) notice something off about this CLI, record it:

midjourney-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
midjourney-pp-cli feedback --stdin < notes.txt
midjourney-pp-cli feedback list --json --limit 10

Entries are stored locally at ~/.midjourney-pp-cli/feedback.jsonl. They are never POSTed unless MIDJOURNEY_FEEDBACK_ENDPOINT is set AND either --send is passed or MIDJOURNEY_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

Output Delivery

Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

SinkEffect
stdoutDefault; write to stdout only
file:<path>Atomically write output to <path> (tmp + rename)
webhook:<url>POST the output body to the URL (application/json or application/x-ndjson when --compact)

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

Named Profiles

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

midjourney-pp-cli profile save briefing --json
midjourney-pp-cli --profile briefing explore list
midjourney-pp-cli profile list --json
midjourney-pp-cli profile show briefing
midjourney-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.

Exit Codes

CodeMeaning
0Success
2Usage error (wrong arguments)
3Resource not found
4Authentication required
5API error (upstream issue)
7Rate limited (wait and retry)
10Config error

Argument Parsing

Parse $ARGUMENTS:

  1. Empty, help, or --help → show midjourney-pp-cli --help output
  2. Starts with install → ends with mcp → MCP installation; otherwise → see Prerequisites above
  3. Anything else → Direct Use (execute as CLI command with --agent)

MCP Server Installation

  1. Install the MCP server:
    bash
    go install github.com/mvanhorn/printing-press-library/library/ai/midjourney/cmd/midjourney-pp-mcp@latest
  2. Register with Claude Code:
    bash
    claude mcp add midjourney-pp-mcp -- midjourney-pp-mcp
  3. Verify: claude mcp list

Direct Use

  1. Check if installed: which midjourney-pp-cli If not found, offer to install (see Prerequisites at the top of this skill).
  2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
  3. Execute with the --agent flag:
    bash
    midjourney-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help: midjourney-pp-cli <command> --help.

© mvanhorn, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 115 other files in library/ai/midjourney of mvanhorn/printing-press-library.

  • SKILL.md
  • .gitignore
  • .golangci.yml
  • .goreleaser.yaml
  • .manuscripts/20260523-212652/proofs/phase5-acceptance.json
  • .manuscripts/20260523-212652/research/research-brief.md
  • .printing-press-patches/.gitkeep
  • .printing-press-patches/ambiguous-write-retries-disabled.json
  • .printing-press-patches/batch-rollback-reports-committed-count.json
  • .printing-press-patches/catalog-go-1264-vuln-floor.json
  • .printing-press-patches/catalog-go-1265-vuln-floor.json
  • .printing-press-patches/midjourney-model-matrix-flags.json
  • .printing-press-patches/midjourney-rendered-download.json
  • .printing-press-patches/midjourney-submit-jobs.json
  • .printing-press-pii-polish.json
  • .printing-press-release.json
  • … and 100 more

Open the folder on GitHubat commit d9a1696

Compare with similar skills

Pp Midjourney next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pp Midjourney compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pp Midjourney this skillmvanhorn/printing-press-library2.1k—~2.4kAutomated safety check: NotesApache-2.0
Midjourney Card News Backgroundsbear2u/my-skills932—~1.4kAutomated safety check: PassNone
Glassify UIMagicCube/agentara516—~2.4kAutomated safety check: PassNone
Nano Banana Pro Prompts Recommend SkillYouMind-OpenLab/nano-banana-pro-prompts-recommend-skill1.9k1 repos~4.1kAutomated safety check: PassNone
Libtv Videonexu-io/nexu3.3k—~3.5kAutomated safety check: PassMIT
Zy Cinematic Realismpopopo-99/zy-cinematic-realism570—~4.6kAutomated safety check: PassCC-BY-NC-4.0

Similar skills

  • Generate Midjourney prompts for 600x600 card news background images based on topic, mood, and style preferences.

    932 GitHub stars~1.4k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed
  • Glassify UI

    MagicCube/agentara

    Transform a UI screenshot into a structured Cinema4D/Octane JSON render prompt for photorealistic 3D poster art.

    516 GitHub stars~2.4k tokensUpdated 5 mo ago
    Media & CreativeAuto-check passed
  • Nano Banana Pro Prompts Recommend Skill

    YouMind-OpenLab/nano-banana-pro-prompts-recommend-skill

    Recommend suitable prompts from 10,000+ Nano Banana Pro image generation prompts based on user needs.

    1.9k GitHub starsUsed in 1 repo~4.1k tokens
    Media & CreativeAuto-check passed
  • Libtv Video

    nexu-io/nexu

    Seedance 2.0 video & image generation via LibTV Gateway - AI text-to-video, image-to-video, video continuation, style transfer, and text-to-image using Seedance 2.0 model.

    3.3k GitHub stars~3.5k tokensUpdated 5 mo ago
    Media & CreativeAuto-check passed
  • Zy Cinematic Realism

    popopo-99/zy-cinematic-realism

    Develop supplied scripts, short stories, or synopses into scene understanding, director-facing art concepts, and motivated narrative keyframes; compile scene ideas, visual references, or existing…

    570 GitHub stars~4.6k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • Image

    Nexus-JPF/note-companion

    When the user wants to create, generate, edit, or optimize images for marketing — blog heroes, social graphics, product mockups, profile banners, listing visuals, or brand assets.

    870 GitHub starsUsed in 3 repos~3.9k tokens
    Media & CreativeAuto-check passed

More from mvanhorn/printing-press-library

All 506 skills in this repo
  • Agent Desktop

    mvanhorn/printing-press-library

    Desktop automation through the real Rust agent-desktop CLI, published in Printing Press through a small bridge.

    2.1k GitHub stars~2.3k tokensUpdated today
    Auto-check: notes
  • Gfonts

    mvanhorn/printing-press-library

    Search, browse, and download Google Fonts from the terminal via the gfonts CLI.

    2.1k GitHub stars~574 tokensUpdated today
    Auto-check passed
  • Pp 1688

    mvanhorn/printing-press-library

    The free, offline Trigger phrases: search 1688 for, find a factory on 1688 for, wholesale price on 1688 for, who is the cheapest supplier on 1688 for, compare 1688 suppliers for, use 1688, run 1688.

    2.1k GitHub stars~3k tokensUpdated today
    Auto-check: notes
  • Pp Activity Japan

    mvanhorn/printing-press-library

    Inspect known Activity Japan plan IDs or URLs, compare dated prices and sessions, check language-sitemap coverage, and hand off to canonical booking pages.

    2.1k GitHub stars~2k tokensUpdated today
    Auto-check: notes
  • Pp Adminbyrequest

    mvanhorn/printing-press-library

    Every Admin By Request portal action, plus a local SQLite mirror of audit, events, inventory and requests for ad-hoc...

    2.1k GitHub stars~3.3k tokensUpdated today
    Auto-check: notes
  • Pp Agent Capture

    mvanhorn/printing-press-library

    macOS screen capture, window recording, GIF conversion, and agent evidence bundles from the terminal.

    2.1k GitHub stars~1.6k tokensUpdated today
    Auto-check: notes

Works with

Questions about Pp Midjourney

What does Pp Midjourney do?

Inspect Midjourney jobs, queue, folders, and discovery feeds from the terminal. Pp Midjourney is an agent skill from mvanhorn/printing-press-library.

When should I use Pp Midjourney?

Pp Midjourney fits situations like: media & Creative work in your project.

How do I install Pp Midjourney in Claude Code?

Run `npx skills add mvanhorn/printing-press-library --skill pp-midjourney -a claude-code`. Or copy the skill folder (library/ai/midjourney in mvanhorn/printing-press-library) into .claude/skills/pp-midjourney in your project. Claude Code loads it when a task matches its description.

How do I install Pp Midjourney in Codex?

Run `npx skills add mvanhorn/printing-press-library --skill pp-midjourney -a codex`. Or copy the skill folder (library/ai/midjourney in mvanhorn/printing-press-library) into .agents/skills/pp-midjourney in your project. Codex loads it when a task matches its description.

Can I use Pp Midjourney in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mvanhorn/printing-press-library --skill pp-midjourney -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pp-midjourney, .gemini/skills/pp-midjourney, .github/skills/pp-midjourney and .opencode/skills/pp-midjourney in your project.

What does Pp Midjourney need to run?

Going by SKILL.md and its folder, Pp Midjourney needs the command-line tools its instructions call (go, claude and npx). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Read, Bash.

Does Pp Midjourney access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Pp Midjourney safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Pp Midjourney use?

Pp Midjourney is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pp Midjourney use?

About 2.4k tokens (SKILL.md is roughly 9.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pp Midjourney?

Skills that share tags, products or a category with Pp Midjourney: Midjourney Card News Backgrounds (bear2u/my-skills, 932 stars), Glassify UI (MagicCube/agentara, 516 stars), Nano Banana Pro Prompts Recommend Skill (YouMind-OpenLab/nano-banana-pro-prompts-recommend-skill, 1.9k stars) and Libtv Video (nexu-io/nexu, 3.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pp Midjourney?

mvanhorn (a GitHub user) maintains it in mvanhorn/printing-press-library, which has 2,056 GitHub stars. The repository holds 506 skills in this directory. The repository was last updated on October 9, 2026.

Source: mvanhorn/printing-press-library on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.