mcpField
B
build-presentation

build-presentation

github.com/ken-guruDocuments185 installsUpdated 1w ago
Repository

About build-presentation

An orchestrator for the Presentation Skill Suite that reads project state and routes work to the next incomplete phase. It handles sequencing and state checks while leaving phase-specific work to independently callable skills.

Key features

  1. 01Routes to the next incomplete phase
  2. 02Checks project state and exit criteria
  3. 03Supports Git checkpoint protocol
  4. 04Offers recovery for ambiguous or corrupt state

Use cases

  1. 01Finding the next step in a presentation project
  2. 02Resuming work from existing project artifacts

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ken-guru/skills --skill build-presentation

After installing, type/build-presentationin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

EXIT_CRITERIA.md
GIT_CHECKPOINTS.md
ROUTING.md
evals/
build-presentation.json

Details

From the project README

Build Presentation (Orchestrator)

Coordinates the Presentation Skill Suite by routing from Project Folder state to the next valid action. It does not contain phase capabilities; each Phase Skill remains independently callable.

Output voice

Apply a lightweight human-voice pass to routing explanations, decision summaries, and completion reports. Prefer concrete state and next actions, preserve the user's requested tone, and leave Project Folder paths, commands, and state names exact. Route every presentation-copy phase through its required standalone unslop pass. The pass must use any editorial preferences recorded in DISCOVERY.json.

Installation boundary

Install this Orchestrator with the complete Presentation Skill Suite. The suite distribution contract keeps each member independently usable after installation.

Startup

  1. Confirm the Project Folder is readable.
  2. If it exists, require PROJECT.json with projectType: "presentation".
  3. Read the Project Folder state and named artifacts directly.
  4. When state is ambiguous or corrupt, report the ambiguity and pause before mutation. Direct the user to inspect or repair the Project Folder.

When the Project Folder is Git-backed, load the conditional Git checkpoint protocol before invoking a Phase Skill.

Routing interface

Detect the first incomplete state in this order:

StateConditionNext action
Nothing startedPROJECT.json is missingOffer discover-presentation
Discovery pendingDiscovery is not doneComplete or redo discover-presentation
Structure pendingDiscovery is done and Structure is not doneOffer structure-agenda
Generation pendingStructure is done and required presentation outputs are incompleteOffer generate-slides
Media pendingA Media Spec exists and its owned media phase is not done or skippedOffer the matching Media Renderer
Proofread pendingPresentation and required media are complete, Proofread is pendingRun proofread-presentation as the fourth phase
CompleteProofread is done or skippedReport completion and offer an explicit rerun path

Use the detailed state-specific dialogue and recovery options in routing guidance only for the detected branch.

Before advancing from Discovery to Structure or Structure to Generation, verify the applicable Exit Criteria. Advance only after every condition passes and the user has chosen the next action where approval is required.

Sequential invocation

When the user chooses a next action, pass the Project Folder path to the selected Skill. Each Skill reads DISCOVERY.json and PROJECT.json and owns its own preflight, Restart Guard, writes, and completion rule.

After a successful Phase Skill invocation, apply the Git checkpoint protocol when enabled, then read state again before offering the next action. Preserve every unrelated phase record.

The supported sequence is:

discover-presentation → structure-agenda → generate-slides →
generate-images/diagrams → proofread-presentation

Media phases may be skipped or run independently when their Media Specs exist.

Comments

Markdown supported