Skip to content
cccskills
FreePublished on GitHub

maestro-integrations

Route Maestro issue-to-task-to-PR work through Orchestra's configured GitHub, Linear, Jira, or Azure DevOps integration and report connection and workflow gaps.

The English summary is being prepared. Showing the original description.

Works withJiraGitHubAzure
See how to install

Files included (1)

  • SKILL.md4.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Maestro integration journeys

Use this skill for cross-project issue discovery, assignment, task execution, and PR linkage. Orchestra is the application; Maestro is the agent.

Resolve the selected backend and exact registered project using orchestra-cli or orchestra_control. Read the project's issue source and tracker connection before choosing a provider. A Git remote or GitHub owner/repository does not make local SQLite tasks into GitHub issues. Blank issue source with no tracker connection currently means SQLite. Copy returned project/task IDs in full into commands; display abbreviations are not executable identities.

Read the matching provider skill under .agents/skills in Maestro's control profile. Maintained repository copies live under .codex/skills; use the control-profile copy during a Maestro session:

  • maestro-github/SKILL.md: repository issues and GitHub PRs, including GitHub PRs attached to Linear/Jira tasks.
  • maestro-linear/SKILL.md: Linear team/issue identity and workflow state.
  • maestro-jira/SKILL.md: Jira site/project/issue identity and workflow mapping.
  • maestro-azure-devops/SKILL.md: Azure Boards/Repos identity and the currently missing adapter.

Keep the journey's identities together: backend, Orchestra project ID, source/connection, external issue ID and URL, task ID, workspace ID/path, requested worker/harness, run observations, and exact PR URL. An issue URL is not a PR URL; a worktree or conversation is not the task. Preserve observed pr_url through task reads and assignment. Report absent linkage rather than constructing a URL from an issue number or branch.

For a supported task flow, observe the exact source inventory, create or resolve the Backlog task, configure/assign it using advertised shared controls, then queue it separately when complete. Retain one UUID and inspect its receipt after uncertainty. Queue acceptance is not proof of a running agent. Observe workspace/run state, then PR head/checks/review state independently. A merged PR does not establish a Done task or authorize checkout deletion.

Use the configured backend for issue-backed task mutations so source routing and receipts are retained. Repository/PR operations may use an available authorized provider tool or CLI, with explicit repository identity. Do not bypass an unavailable shared task mutation using a guessed HTTP endpoint. Never copy credentials into agent files, prompts, issues, or skills.

The pipeline contract applies to every harness. Todo plans and waits for explicit human approval of the returned exact plan hash. Maestro may forward a human's explicit approval through an advertised shared control, but must never infer approval from planning completion, agent feedback, or a request to fix the pipeline. In Progress executes only the approved current context. Replanning retains the existing code, worktree, PR and feedback while invalidating the old approval. A different provider does not bypass these gates; verify that its adapter supports the required stage controls before dispatching.

PR review is a separate agent stage bound to the exact repository, PR and current head commit. Preserve reviewer identity and feedback. Requested changes return to planning with that context; a clean agent review waits for human approval. Never treat a review result as human approval, merged-head evidence, or permission to mark Done. Use only review controls advertised by the selected executable; missing controls are an implementation gap, not permission to imitate them with generic task state patches.

Connection configuration, adapter presence, and fixture tests are separate from a successful authenticated read. Report authentication failure as connection failure, not an empty inventory. Hosted adapters currently have routing/state/assignment limits; a source skill describes them and does not enable a missing operation. Do not change the selected tracker or fall back to a different provider to make a request appear successful.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

commit

Free

Create a well-formed git commit from current changes using session history for rationale and summary; use when asked to commit, prepare a commit message, or finalize staged work.

The English summary is being prepared. Showing the original description.

Traves-Theberge/Orchestra26Updated Oct 15, 2026

debug

Free

Investigate stuck runs and execution failures by tracing Symphony and Codex logs with issue/session identifiers; use when runs stall, retry repeatedly, or fail unexpectedly.

The English summary is being prepared. Showing the original description.

Traves-Theberge/Orchestra26Updated Oct 15, 2026

land

Free

Land a PR by monitoring conflicts, resolving them, waiting for checks, and squash-merging when green; use when asked to land, merge, or shepherd a PR to completion.

The English summary is being prepared. Showing the original description.

Traves-Theberge/Orchestra26Updated Oct 15, 2026

linear

Free

Native Linear integration using internal tracker tools. Supports issue querying, state transitions, and audit logging.

The English summary is being prepared. Showing the original description.

Traves-Theberge/Orchestra26Updated Oct 15, 2026

Guide Maestro's Azure Boards and Repos task/PR identity and connection requirements while identifying Orchestra's currently unavailable Azure DevOps tracker operations.

The English summary is being prepared. Showing the original description.

Traves-Theberge/Orchestra26Updated Oct 15, 2026

Use GitHub repository issues and pull requests for Maestro task journeys, preserving Orchestra project identity, source routing, and exact PR linkage.

The English summary is being prepared. Showing the original description.

Traves-Theberge/Orchestra26Updated Oct 15, 2026

See all skills by Traves-Theberge

Report a problem with this skill