zz-router

Routes ZZ platform delivery requests to the correct installed flow and loads it.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/zhixuan312/zz-stack --skill zz-router-zhixuan312
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zz-router
Source: https://github.com/zhixuan312/zz-stack/tree/main/marketplace/zz-core/skills/zz-router
Command: npx skills add https://github.com/zhixuan312/zz-stack --skill zz-router-zhixuan312

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working on the ZZ platform, delivery requests must follow an installed flow with declared stages, documents, and approval gates. This Skill removes the guesswork of choosing the right flow by inspecting the request and dispatching to the correct one, while preventing agents from resuming work from conversation memory instead of the platform's recorded state. ## Core Features & Use Cases - Flow selection: Distinguishes between sdlc-flow for software delivery work and zz-plugin-eval for grading or confirming readings of plugins, then loads the chosen flow via the zz-core skill_read MCP tool. - Initiative resumption: Calls initiative_status to compute the next move from the flow manifest and document envelopes when continuing existing work, never relying on conversation memory. - Governance enforcement: Ensures documents are written through document_write, document_patch, or document_revise into the team store, and that gates pass only through recorded document_approve calls. - Use Case: A team member says "continue the payment-service initiative" — the Skill first calls initiative_status to find the current stage, then loads sdlc-flow and follows its method exactly. ## Quick Start Ask the agent to continue an existing ZZ initiative or start new delivery work, and it will route the request to the right installed flow.

Frequently Asked Questions about zz-router

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

FAQPage Schema
How do I continue existing delivery work on the ZZ platform?▼

Call initiative_status with the initiative name, or with no argument to list open work. It computes the next move from the flow's manifest and the documents' own envelope, so you never resume from conversation memory.

How do I choose between sdlc-flow and zz-plugin-eval?▼

Use sdlc-flow for software delivery work such as grounding a brain dump, writing an agreement, or making a change. Use zz-plugin-eval when someone asks whether a plugin is good, wants it graded, or asks you to confirm a reading they already formed.

When should I not use the zz-router skill?▼

Do not use it for ordinary coding, debugging, or questions about the repository itself. It is only for delivery work for your team on the ZZ platform, such as new capabilities or changes to services someone operates.

Why can't I approve a document by saying yes in the conversation?▼

A gate passes only once document_approve(path) has recorded it. The platform stamps who approved and when, and refuses approval fields written by hand, so a conversational yes is not an approval.

Can I write documents directly into the repository?▼

No. Documents are written through document_write, document_patch, or document_revise into your team's store. You send only the body; the platform writes the frontmatter and refuses content that opens with one.