CI Version Claude Code License
> utils_capabilities
{"host":{"platform":"darwin","arch":"arm64"},"registered":["utils_capabilities",
"gmaps_get_list","md2slide_init","md2slide_build","pdf_info","pdf_extract_text",
"pdf_extract_comments","pdf_compress","pdf_decrypt","pdf_merge","pdf_split",
"pdf_rotate","pdf_render"],"hidden":[]}
Skills, agents and tools used to live in separate repos. Each machine then had a different mix. This plugin puts them in one repo under one namespace, zyx:*, so one install gives every machine the same set. Each structural change has an ADR in decisions/.
Features
- Skills: house rules for slides, project docs, academic writing, Next.js, the dev workflow and photorealistic image prompts.
- Worker agents:
planner,surveyorandreviewerreturn structured reports, not chat.reviewertries to refute a claim before it counts, and thedual-reviewskill pairs it with a Codex review for high-risk changes.surveyorandreviewergrade each claim with the Admiralty Code. - utils MCP server: 13 tools for PDFs, Google Maps lists and Markdown slides. The plugin registers the server for you.
- Host-aware tools: the server registers only the tools that this machine can run, and
utils_capabilitiesreports the rest.
Quick start
Claude Code 2.1.186 or later:
claude plugin marketplace add zyx1121/plugin
claude plugin install zyx@zyx
Start a new session and ask for utils_capabilities. The tools appear as mcp__plugin_zyx_utils__<tool>.
Codex gets the skills only: install zyx@zyx1121 from zyx1121/marketplace.
Usage
| Part | Contents |
|---|---|
| skills/ | academic-sentence, alint, article, create-verify, dev-workflow, dual-review, human-voice, nextjs-dev, paper-revise, photo-realism, project-docs, simple-first, video, winlab-pptx, xiao-lin-shuo |
| agents/ | planner, surveyor, reviewer, alint, utils-promoter |
| utils/ | MCP tools: pdf_* (9), md2slide_init, md2slide_build, gmaps_get_list, utils_capabilities |
| decisions/ | ADRs for each merge, extraction and retirement |
Skills load when a request matches their description. Agents run through the Agent tool as zyx:<name>.
To add a tool, give a script to the utils-promoter agent. It writes a PEP 723 script in utils/scripts/, adds an MCP tool when agents will call it, and opens a PR.
Configuration
| Needs | For |
|---|---|
bun | the utils MCP server |
uv | the PDF, slide and Maps scripts |
gs (Ghostscript) | pdf_compress only |
| admiralty-code plugin | grades in surveyor and reviewer reports |
No secrets. A local clone as the marketplace serves skill edits after git pull: claude plugin marketplace add <clone>, then claude plugin update zyx@zyx.
Limits
- Do not also register
utilsat user scope. A user-scope server with the same name hides the plugin server. - PVE, NYCU, macOS and Uber Eats tools moved to their own plugins: pve, nycu, macos, ubereats. ADR-0012 to ADR-0014 tell why.
For AI agents
Facts for coding agents and LLM tools. The rules for changing the code are in AGENTS.md.
- Summary: Claude Code plugin
zyxwith 15 skills, 5 worker agents and a bundled stdio MCP server (utils, 13 tools). - Type: plugin
- Interfaces: skills
zyx:<skill>, agentszyx:<agent>, MCP toolsmcp__plugin_zyx_utils__<tool> - Install:
claude plugin marketplace add zyx1121/plugin && claude plugin install zyx@zyx - Run: Claude Code starts the server from
.mcp.json(bun run utils/mcp/src/server.ts) - Verify:
cd utils/mcp && bun install --frozen-lockfile && bun run typecheck && bun test - Config: none. Tool registration depends on
uvandgson the host. - Secrets: none
- Limits: Claude Code 2.1.186 or later. Codex reads the skills only.
Development
cd utils/mcp
bun install --frozen-lockfile
bun run typecheck
bun test
CI runs the same commands. A version bump changes .claude-plugin/plugin.json, .claude-plugin/marketplace.json and plugin.json together.