amos

Pick up and execute the next ready-to-start issue from the focused milestone, end-to-end: announce, gate on user confirmation, branch, do the work, run the tests listed in the issue body, open a PR, report. This is the skill to invoke when the user says "continue", "next task", "what's next", "pick up where we left off", "work on the next issue", "keep going", or similar. It replaces any project-local PROMPT.md protocol.

File a new GitHub issue with a well-shaped body, the right milestone, and native dependency relationships, from a short natural-language intent. Use when the user says "file this", "open an issue for X", "create a ticket", "log this as a bug", when discussion surfaces a new task that should be tracked, or after the assistant offered to file something and the user confirmed. Infers milestone and labels; asks in chat whenever confidence is low.

Load when working with amos nodes — markdown files carrying `whoami: amos` frontmatter — or when the user refers to "the plan", "the DAG", "the roadmap", "the tickets", "what's next", or similar work-tracking concepts. Installs the amos conventions (canonical naming, node format, when to reach for which sub-skill) into context so amos-graph, amos-show, amos-create, and amos-notify can be used correctly. Does not run the CLI on its own.

Set the milestone the user is currently working on. `amos next`, `amos blocked`, and `amos graph` scope their output to this milestone once set. Use when the user says "let's work on <milestone>", "focus on <milestone>", "switch to <milestone>", or wants to check which milestone is currently active. Accepts free-form milestone text — the tool resolves it against the adapter's known titles.

Scaffold a new amos node with proper frontmatter. Use when the user wants to add a new ticket, task, or plan entry tracked by amos. Produces a markdown file with the canonical `@github:<owner>/<repo>#<N>` name, a description, dependencies, and the adapter block.

Print the amos dependency tree as a nested ASCII graph. Use when the user asks about open tasks, the roadmap, what's next, what's blocked, what depends on X, or wants a structural view of the plan. Returns every node with status and a short description; does NOT resolve `@github:...` references (use amos-show for full content). Trigger on phrases like "what's on my plate", "what's open", "show me the DAG", "what's blocking X", "what depends on Y", "where are we on <umbrella>".

Post a message to a node's source system through its adapter. For a `@github:...` node, this creates a comment on the referenced issue. Use when the user wants to share status, results, or context with everyone watching the upstream tracker — not for local scratch notes. The message is visible to anyone with access to the tracker.

Resolve a single amos node to its fully expanded content — frontmatter summary plus the remote body fetched via the adapter (e.g. GitHub issue body). Use when the user asks about a specific ticket or node ("tell me about #322", "what's #319 about", "show me the MoQ plan"). Use amos-graph for structural views across many nodes, and Read for just the local markdown without a remote fetch.