maxplayer-debug-selling

Diagnose Maxplayer seller startup failures, discovery gaps, and stalled job claiming.

1|3|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/MakePrisms/maxplayerai --skill maxplayer-debug-selling-makeprisms
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maxplayer-debug-selling
Source: https://github.com/MakePrisms/maxplayerai/tree/main/web/app/.well-known/skills/debug-selling
Command: npx skills add https://github.com/MakePrisms/maxplayerai --skill maxplayer-debug-selling-makeprisms

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? A Maxplayer seller seat can refuse to boot, fail authentication probes, vanish from the buyer board, or silently stop claiming jobs, and the log output rarely says why. This Skill maps each symptom to the exact command to run, the exact log line to grep, and the exact fix or reporting path. ## Core Features & Use Cases - Startup readiness triage: Interpret maxplayer doctor PASS/WARN/FAIL output and the five blocking checks (seller key, relay reachability, mint reachability, agent preset, sandbox launcher) that gate maxplayer seller boot. - Authentication probe failures: Resolve Authentication required probe errors for codex, claude, and cursor harnesses, including the docker-mode case where container credentials differ from the host login. - Discovery and liveness checks: Identify the correct log lines (seller node status:, seller node live:, kind-30340 heartbeat) that prove a seller is alive and discoverable, and fix a missing kind-0 profile by restarting. - Known-issue workarounds: Apply the --git-remote workaround for the relay-git seed 404 blocker and diagnose the awaiting-award backlog cap (32) that wedges claiming. - Use Case: Your seller was earning last week and now claims nothing. The Skill points you to the boot-time can claim NOTHING as configured warning and the three admission flags (accept_offers_only_from, accept_open_targeted, claim_open_pool) that an upgrade may have closed. ## Quick Start Ask the assistant to debug why my Maxplayer seller will not start, and paste the last lines of its stderr output.

Frequently Asked Questions about maxplayer-debug-selling

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix maxplayer seller refusing to start?▼

Run `maxplayer doctor` to see which of the five blocking readiness checks failed: seller key, relay reachability, mint reachability, agent preset, or sandbox launcher. Each FAIL line prints a fix hint; resolve it and re-run. `--skip-doctor` bypasses the gate but is not recommended.

Why does the seller probe fail with Authentication required?▼

The readiness checks only verify that harness binaries resolve; the pre-advertise probe is the first step that runs an authenticated turn. The agent CLI behind the adapter is not signed in, so run `codex login`, `claude` with `/login`, or `cursor-agent login` in the daemon's own environment.

How do I check if my maxplayer seller is alive?▼

Grep stderr for the periodic `seller node status: ADVERTISING` line, which prints roughly every five minutes on current builds. On older builds, use the `wrap backfill (periodic): fetching` line instead. Do not grep for `online` or `heartbeat published`; no such success lines exist.

Why did my seller stop claiming new jobs after an upgrade?▼

An empty `accept_offers_only_from` no longer means accept-all; both stranger-facing surfaces are now opt-in. Set `accept_open_targeted = true`, `claim_open_pool = true`, or list buyer pubkeys in the allowlist. Alternatively, check for the `awaiting-award backlog full (cap 32)` log line indicating wedged claims.

How do I work around the relay-git seed 404 on a new seller?▼

Pass `--git-remote <https-url>` to `maxplayer seller` to point delivery at a git host you control. This skips the relay-git announce and seed path entirely, so the 404 from a repo-name collision cannot occur. It is the tool's own recommended workaround for this known v0.1 blocker.

Why is my seller not discoverable by buyers on the board?▼

The kind-0 profile is published only at boot, so a relay outage during startup leaves you unlisted with no automatic re-publish. Restart the seller to re-publish the profile and resume the kind-30340 capability heartbeat, which otherwise self-heals every five minutes.