orchestrator-recipe-generator

Generate orchestrator session recipes and seed files for Hall9k projects and nodes.

Updated Aug 16, 2026
One-click install
npx skills add https://github.com/Hallmanac/hall9k --skill orchestrator-recipe-generator-hallmanac
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orchestrator-recipe-generator
Source: https://github.com/Hallmanac/hall9k/tree/main/.claude/skills/orchestrator-recipe-generator
Command: npx skills add https://github.com/Hallmanac/hall9k --skill orchestrator-recipe-generator-hallmanac

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a Hall9k project or node requires a consistent, machine-specific orchestrator recipe: the prompts and seed files that let a human launch a disposable orchestrator session from a terminal. Writing these by hand risks drift, invented rules, and guessed facts about the machine or platform. ## Core Features & Use Cases - Dual-mode generation: Runs in project mode (resolved via h9k project show) or node mode (resolved via h9k config show), each producing its own recipe set. - Observed-fact discovery: Inspects the OS, shell, daemon log path, agent CLIs, concurrency ceiling, budget, and registered projects through h9k CLI commands rather than assumptions. - Safe regeneration: Never overwrites existing recipes; writes .new siblings for reconciliation, seeds journal.md, sessions.md, and background log-waiter scripts only when absent. - Use Case: After installing Hall9k on a new machine or registering a new project, run this Skill to produce recipes/orchestrator.md, scoped-session recipes, and a byte-offset polling waiter script tailored to that machine's shell and log paths. ## Quick Start Ask the agent to run the orchestrator-recipe-generator skill to generate this project's orchestrator recipe from its home directory.

Frequently Asked Questions about orchestrator-recipe-generator

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

FAQPage Schema
How do I generate an orchestrator recipe for a Hall9k project?

Run the skill from inside the project's home directory or a worktree beneath it. It resolves the project via `h9k project show`, discovers machine and platform facts, then writes `recipes/orchestrator.md` plus scoped-session recipes and seed files.

What is the difference between project mode and node mode?

Project mode runs from a project's home and writes recipes scoped to that project's work. Node mode runs from the node's home (found via `h9k config show`) and writes a single recipe covering the daemon, concurrency ceiling, budget, and project registration.

Does the recipe generator overwrite existing recipe files?

No. If a recipe already exists, the generator writes a `.new` sibling file instead. The platform's launch-anchor compares the two and walks the operator through adopting, keeping, or merging them at the next launch.

Why does the recipe use a background waiter script instead of the Monitor tool?

A standing ruling found that Monitor expires every thirty minutes and wakes the window on each expiry and re-arm. The waiter polls `h9kd.log` by byte offset, tallies routine lines silently, and only surfaces actionable lines to the operator.

What happens if launch-anchor.md or settings.json is missing?

The skill stops and tells the operator to run `h9k project init <name>` or `h9k install` first. Those two files are platform-owned and rendered by the CLI, never written by the recipe generator.