orient

Routes agent work to the correct mx skill or workflow based on the current situation.

3|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/MaxWolf-01/agents --skill orient-maxwolf-01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orient
Source: https://github.com/MaxWolf-01/agents/tree/main/mx/skills/orient
Command: npx skills add https://github.com/MaxWolf-01/agents --skill orient-maxwolf-01

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working on multi-session agent projects with an agent/ directory, it is hard to know which workflow skill fits the current situation: grilling, ticketing, dispatch, research, or handoff. This Skill acts as a router over the entire mx workflow so you pick the right flow before starting nontrivial work. ## Core Features & Use Cases - Workflow Routing: Maps your current situation to the right mx skill, from grilling an intent through dispatching tickets to landing a review. - Artefact Guide: Explains the lifecycle and location of every artefact (specs, tickets, ADRs, research, prototypes) so work lands in the right place. - Phase Boundary Decisions: Provides an ordered decision tree (Continue, /clear, subagent, handoff) for managing context between phases of a session. - Use Case: You return to a project with an agent/ directory and a half-finished feature. Invoke the orient skill to determine whether to resume grilling, dispatch open tickets, or hand off to a fresh session. ## Quick Start Ask the agent to orient you on which mx skill or flow fits the current state of your project before starting the next piece of work.

Frequently Asked Questions about orient

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

FAQPage Schema
How do I choose which mx skill to use for a task?

Invoke the orient skill before starting nontrivial work. It walks the main flow from intent to ship and points you to grilling, ticketing, dispatch, or standalone skills based on whether the work needs a design round, a brief, or neither.

When should I use a ticket versus a spec in an agent workflow?

Use a standalone ticket when one worker can build the change from a single what-to-build plus acceptance criteria. Use a spec when the builder would need to ask the user about behavior, interfaces, or data shapes, or when the work spans several slices.

What is a phase boundary in agent session management?

A phase boundary is the gap between two chunks of work in a session, such as grilling and implementation. At each boundary you decide in order: continue, clear the context, delegate to a subagent, or hand off to a fresh session via a portable markdown file.

When should I use handoff instead of compact for context?

Use handoff when the context is still relevant but the session cannot continue, because it produces an inspectable markdown file you can proofread before seeding a fresh session. Compact summaries are black boxes that can flatten decisions, so they are excluded from the decision ladder.

Does the orient skill require an existing agent directory?

It is designed for projects with an agent/ directory containing tickets, research, and prototypes, and should be called before nontrivial work there. Parts of its guidance, such as bare grilling, also apply when no repository is involved.