Skip to content

feat: add Maestro CLI skill for runtime management#63

Draft
ankitjain91 wants to merge 7 commits intomainfrom
feat/add-maestro-skill
Draft

feat: add Maestro CLI skill for runtime management#63
ankitjain91 wants to merge 7 commits intomainfrom
feat/add-maestro-skill

Conversation

@ankitjain91
Copy link
Copy Markdown

Summary

  • Add new skills/uipath-maestro/ skill with SKILL.md and references/maestro-commands.md documenting all uip maestro CLI commands (instances, processes, incidents)
  • Update hooks/ensure-uip.sh to auto-install @uipath/maestro-tool on session start
  • Add maestro keyword to plugin.json and cross-link Maestro in the platform skill's CLI reference and task navigation

Details

The new Maestro skill mirrors the structure of uipath-flow but is scoped to runtime management only (no init/validate/pack — Maestro processes are authored in Studio Web). It covers:

  • Instances (13 subcommands): list, get, pause, resume, cancel, retry, goto, input, deadline, create-note, list-notes, update-priority, list-tasks
  • Processes (2 subcommands): list, get
  • Incidents (1 subcommand): list

Key documentation includes:

  • Shell quoting guidance for the goto command's JSON array argument
  • --folder-key vs --folder-id distinction between Maestro and Flow
  • Common workflow examples (monitoring, handling faults, navigating stuck instances)

Test plan

  • Verify skills/uipath-maestro/SKILL.md YAML frontmatter parses correctly (name, description, allowed-tools)
  • Verify all cross-links between SKILL.md and references/maestro-commands.md resolve
  • Verify hooks/ensure-uip.sh passes bash -n syntax check
  • Verify plugin.json is valid JSON with maestro keyword
  • Verify Maestro appears in uip-commands.md Other Tool Groups table
  • Verify Maestro appears in platform SKILL.md CLI Overview table and Task Navigation

🤖 Generated with Claude Code

claude and others added 5 commits March 24, 2026 14:29
…start

Create the main Maestro skill file modeled after uipath-flow/SKILL.md,
covering runtime management of Maestro process instances, processes,
and incidents via the uip maestro CLI commands.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Document all 3 command groups: instances (13 subcommands), processes (2),
and incidents (1) with parameter tables, bash examples, and common
workflows. Includes quoting guidance for the goto command's JSON array arg.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add ensure_uip_tool call for @uipath/maestro-tool so the Maestro CLI
plugin is available automatically on session start.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add Maestro to the Other Tool Groups table in uip-commands.md, the CLI
Overview table in platform SKILL.md, and a task navigation entry linking
to the new uipath-maestro skill.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 45d8917225

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@nikhil-maryala nikhil-maryala marked this pull request as draft March 24, 2026 14:45
nikhil-maryala and others added 2 commits March 24, 2026 16:07
- Add uipath-maestro entry to README.md Skill Catalog table
- Update hooks.json statusMessage to mention maestro-tool

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Fixed the uip binary resolver logic in Quick Start Step 0 to properly handle
both cases:
1. When uip is on PATH: use the full path directly (without appending /bin/uip)
2. When uip is not on PATH: resolve via npm and append /bin/uip only as fallback

This prevents the creation of invalid paths like /usr/local/bin/uip/bin/uip.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
@nikhil-maryala nikhil-maryala marked this pull request as ready for review March 24, 2026 16:12
@nikhil-maryala nikhil-maryala marked this pull request as draft March 24, 2026 16:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants