Agent skill

Cy Orquestrate Issue

by compozy in compozy/compozy

Orchestrate GitHub bug resolution through a new CompozyOS managed worktree and Codex Astra High session per issue.

MITAuto-check passedDevelopment

Install Cy Orquestrate Issue

skills CLI
$ npx skills add compozy/compozy --skill cy-orquestrate-issue -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install compozy/compozy cy-orquestrate-issue --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/compozy/compozy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/cy-orquestrate-issue .claude/skills/cy-orquestrate-issue && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cy-orquestrate-issue
GitHub stars
2.8k
Token cost
~1.9k tokens
SKILL.md length
931 words
Files
2 (incl. assets)
Skills in repo
47
Repo updated
First seen
Licence
MIT

At a glance

Orchestrate GitHub bug resolution through a new CompozyOS managed worktree and Codex Astra High session per issue.

  • Works in 4 steps: Load the runtime contract → Investigate and establish the issue → Create and bind the executor → …
  • Asked to delegate issue resolution
  • SKILL.md covers Contract and inputs, 1. Load the runtime contract, 2. Investigate and establish… and 3. Create and bind the executor, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Cy Orquestrate Issue is an agent skill from compozy/compozy. Orchestrate GitHub bug resolution through a new CompozyOS managed worktree and Codex Astra High session per issue. Investigate reported bugs, create missing issues, and dispatch a Goal-backed executor responsible for a detailed PR, green CI, and all CodeRabbit and Greptile feedback. Use when asked to delegate issue resolution; excludes spec task graphs, direct implementation, and review-only work on an existing PR.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including assets (for example `assets/executor-prompt.md`).

It sits in Development, covering Git worktrees. It works with GitHub. The repository describes itself as: An operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each… The licence is MIT.

When your agent uses it

  • Asked to delegate issue resolution
  • Excludes spec task graphs
  • Direct implementation
  • Review-only work on an existing PR

Example prompts

  • “/cy-orquestrate-issue”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Load the runtime contract
  2. Investigate and establish the issue
  3. Create and bind the executor
  4. Follow-ups and delivery

What it can do on your machine

Read from SKILL.md and the folder at commit eec2ed1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cy Orquestrate Issue loads about 1.9k tokens when it runs. Until then it costs about 110 tokens; SKILL.md has 931 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~110
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from compozy/compozy at commit eec2ed1, republished under its MIT licence (© compozy). 931 words, ~1,892 tokens.

Download SKILL.mdSave it as .claude/skills/cy-orquestrate-issue/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
cy-orquestrate-issue
description
Orchestrate GitHub bug resolution through a new CompozyOS managed worktree and Codex Astra High session per issue. Investigate reported bugs, create missing issues, and dispatch a Goal-backed executor responsible for a detailed PR, green CI, and all CodeRabbit and Greptile feedback. Use when asked to delegate issue resolution; excludes spec task graphs, direct implementation, and review-only work on an existing PR.

Orchestrate Issue Resolution

The orchestrator investigates and dispatches; a dedicated CompozyOS session implements each issue through PR delivery.

Contract and inputs

  • Accept issue numbers/URLs or a bug report with screenshots, logs, or reproduction steps. Resolve the repository from the workspace remote; ask only if the target remains ambiguous.
  • Default executor: agent general, provider codex, model gpt-6-astra, reasoning effort high. Explicit user overrides win. Verify the effective runtime; never silently substitute a model.
  • Create one new managed worktree and new logical session per issue. Follow-ups for that issue go to its recorded session. Never repurpose an unrelated active session.
  • An invocation to resolve issues authorizes the scoped issue, branch, push, PR, review replies, and review-remediation work. It does not authorize merge, destructive Git, deleting worktrees, installing reviewers, or changing the user's host runtime. Existing session authorization wins.
  • Default orchestration ends after verified dispatch, with the executor responsible for the full delivery contract. If asked to accompany delivery, supervise until that contract is satisfied. A launch report must say in progress, never that the issue is resolved.

1. Load the runtime contract

Use the active harness to resolve compozy__skill_view. Load the Compozy skill and the full references selected by its router for tools, worktrees, sessions, orchestration, and Goals: references/tools-and-skills.md, references/native-tools.md, references/worktrees.md, references/runtime-operations.md, references/tasks-and-orchestration.md, and references/loops.md. Reuse complete current reads from this session. Follow source-qualified command_id and retained-result continuation instructions when supplied.

Discover capabilities with compozy__tool_search and inspect live descriptors with compozy__tool_info. The canonical IDs below are discovery keys, not harness invocation names. Use the returned references and current schemas. A denied tool/skill read is not permission to bypass policy through CLI or filesystem access.

2. Investigate and establish the issue

Read workspace instructions, Git status, the issue and its comments, and the affected code paths. Reuse prior evidence; perform focused read-only investigation before dispatching a new bug report. For runtime incidents, compare public daemon state and relevant logs with the UI report. Separate confirmed causes, hypotheses, and unverified observations. Do not mutate user sessions to reproduce. Use bounded independent explorers only when authorized and useful.

For a report without an issue, check for duplicates, then create an English GitHub issue containing reproduction, actual/expected behavior, evidence and code pointers, acceptance criteria, and relevant QA/compatibility impact. Verify publication. Sanitize private paths, internal runtime identifiers, credentials, and unrelated log content. Use structured arguments or a body file for multiline text. For an existing issue, reuse it; do not create a duplicate. A closed issue or existing PR requires checking whether work remains before creating another implementation.

Several symptoms may belong to one evidenced defect. Keep that scope together; independent issues get separate worktrees. Include later user corrections in the same issue's briefing. Avoid a broad spec, audit, or unrelated cleanup unless requested.

Show full SKILL.md (474 more words)Show less

3. Create and bind the executor

Refresh the remote base without changing the root checkout. Use the repository's target branch, normally origin/main. Keep a compact mapping of issue URL, base SHA, worktree ID/path/branch, session ID, prompt idempotency key, and eventual PR URL in the orchestration context. Preserve that mapping in a handoff when needed; daemon state remains authoritative.

Perform these dependent operations in order:

  1. compozy__worktree_create: workspace, base ref, unique name such as issue-<number>-<slug>, branch such as fix/issue-<number>-<slug>.
  2. compozy__worktree_inspect: confirm creation reached ready, and retain the returned path/ID.
  3. compozy__session_create: selected agent, descriptive issue name, exact workspace/worktree ID.
  4. Load assets/executor-prompt.md, fill every field, and send the full briefing with compozy__session_prompt. Set runtime explicitly on this first prompt: {"provider":"codex","model":"gpt-6-astra","reasoning_effort":"high"} unless overridden. Use unique stable message_id and idempotency_key; use wait:false for background dispatch.
  5. compozy__session_status: confirm the prompt is accepted, runtime ready with the requested effective selection, and the session bound to the intended worktree. The executor verifies cwd and branch before editing. Inspect compozy__goal_control status to confirm actual activation; distinguish requested, activated, and executing successfully.

If creation or prompt admission has an ambiguous result, reconcile the worktree/session catalog against the recorded mapping before retrying. Replay the same prompt idempotency key where supported; do not blindly create duplicates. Respect session limits; never change the session type to bypass a denial. This flow uses logical worktree-bound sessions, not the spec-task spawn/lease workflow.

If a required operation fails, complete independent work and report the precise blocker. Do not claim a pending worktree, unbound runtime, or merely accepted prompt is executing successfully.

4. Follow-ups and delivery

Send additional evidence only to the same issue's recorded executor. Inspect its current turn and busy-input capabilities: queue nonurgent additions; steer only when timely correction is needed, using the expected active turn and checking whether the runtime would interrupt. Do not assume a slash-shaped string in an agent prompt activates a skill or Goal; require the native operation.

The executor prompt owns implementation, validation, PR description, and the complete review cycle. Do not duplicate its checks or routinely interrupt it for status. If supervising, investigate finished CI failures while other jobs run and inspect new review evidence after relevant pushes. An idle turn or active Goal flag alone is neither completion nor a blocker. If Goal supervision fails while ordinary work continues, preserve the evidence, avoid repeated activation, and continue authorized work; do not repair the host or clear runtime records as a shortcut.

Report the issue links, worktree/branch and session mapping, verified runtime/Goal state, and actual launch or delivery status concisely. Do not stop the executor or remove its worktree after dispatch. At delivery, verify the PR head, required checks, both reviewers' completed coverage, all finding dispositions, and current description. Missing/red/pending CI or missing reviewer evidence means delivery is still in progress or externally blocked. No merge unless separately requested.

© compozy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (assets) in .agents/skills/cy-orquestrate-issue of compozy/compozy.

  • SKILL.md
  • assets/executor-prompt.md

Open the folder on GitHubat commit eec2ed1

Compare with similar skills

Cy Orquestrate Issue next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cy Orquestrate Issue compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cy Orquestrate Issue this skillcompozy/compozy2.8k—~1.9kAutomated safety check: PassMIT
Pre-Release PR Triagejamiepine/voicebox57k—~3.1kAutomated safety check: PassMIT
Codewhale Landing Workflowcodewhale-hq/Codewhale41k—~1.6kAutomated safety check: PassMIT
Ff Worktreesdamus-io/damus2.1k—~451Automated safety check: PassGPL-3.0
Clean Complete Branchesjtenniswood/espcontrol1.1k—~820Automated safety check: PassCustom licence
Clean Merged Branch Foldersjtenniswood/espcontrol1.1k—~813Automated safety check: PassCustom licence

Similar skills

  • Pre-Release PR Triage

    jamiepine/voicebox

    Sorts a backlog of open pull requests into must-merge, candidate, superseded and deferred, writes a triage doc and works the merge loop before a release.

    57k GitHub stars~3.1k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Codewhale Landing Workflow

    codewhale-hq/Codewhale

    Decides how verified work should reach main, directly, in a worktree or on an integration branch, while keeping contributor credit and respecting merge gates.

    41k GitHub stars~1.6k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Ff Worktrees

    damus-io/damus

    Fast-forward master and every git worktree branch up to a target ref (default github/master), skipping any worktree with unmerged commits.

    2.1k GitHub stars~451 tokensUpdated 27 days ago
    DevelopmentAuto-check passed
  • Clean Complete Branches

    jtenniswood/espcontrol

    Clean up completed Git branches and worktrees for this repository both locally and on GitHub.

    1.1k GitHub stars~820 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Clean Merged Branch Folders

    jtenniswood/espcontrol

    Clean up local branch worktree folders for this repository after their branches or pull requests have merged to main.

    1.1k GitHub stars~813 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Fix

    exercism/website

    Fix a GitHub issue end-to-end — fetches issue, creates worktree, plans and implements fix, runs validation, opens PR, cleans up.

    550 GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-check: notes

More from compozy/compozy

All 47 skills in this repo
  • Eng Real Scenario QA

    compozy/compozy

    Dogfoods Compozy through an autonomous startup scenario with live providers, cross-surface observation, and strict evidence audit.

    2.8k GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Eng Test Conventions

    compozy/compozy

    Go test-shape discipline for Compozy. An agent skill from compozy/compozy.

    2.8k GitHub stars~467 tokensUpdated today
    Auto-check passed
  • Assistant UI

    compozy/compozy

    Guide for assistant-ui library - AI chat UI components. An agent skill from compozy/compozy.

    2.8k GitHub stars~958 tokensUpdated today
    Auto-check passed
  • Guide for assistant-ui UI primitives - ThreadPrimitive, ComposerPrimitive, MessagePrimitive.

    2.8k GitHub stars~999 tokensUpdated today
    Auto-check passed
  • Assistant UI Runtime

    compozy/compozy

    Guide for assistant-ui runtime system and state management. An agent skill from compozy/compozy.

    2.8k GitHub stars~856 tokensUpdated today
    Auto-check passed
  • Assistant UI Streaming

    compozy/compozy

    Guide for assistant-stream package and streaming protocols. An agent skill from compozy/compozy.

    2.8k GitHub stars~813 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Cy Orquestrate Issue

What does Cy Orquestrate Issue do?

Orchestrate GitHub bug resolution through a new CompozyOS managed worktree and Codex Astra High session per issue. Cy Orquestrate Issue is an agent skill from compozy/compozy. Orchestrate GitHub bug resolution through a new CompozyOS managed worktree and Codex Astra High session per issue.

When should I use Cy Orquestrate Issue?

Cy Orquestrate Issue fits situations like: asked to delegate issue resolution; excludes spec task graphs; direct implementation; review-only work on an existing PR.

How do I install Cy Orquestrate Issue in Claude Code?

Run `npx skills add compozy/compozy --skill cy-orquestrate-issue -a claude-code`. Or copy the skill folder (.agents/skills/cy-orquestrate-issue in compozy/compozy) into .claude/skills/cy-orquestrate-issue in your project. Claude Code loads it when a task matches its description.

How do I install Cy Orquestrate Issue in Codex?

Run `npx skills add compozy/compozy --skill cy-orquestrate-issue -a codex`. Or copy the skill folder (.agents/skills/cy-orquestrate-issue in compozy/compozy) into .agents/skills/cy-orquestrate-issue in your project. Codex loads it when a task matches its description.

Can I use Cy Orquestrate Issue in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add compozy/compozy --skill cy-orquestrate-issue -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cy-orquestrate-issue, .gemini/skills/cy-orquestrate-issue, .github/skills/cy-orquestrate-issue and .opencode/skills/cy-orquestrate-issue in your project.

What does Cy Orquestrate Issue need to run?

SKILL.md names no scripts, command-line tools or credentials: Cy Orquestrate Issue is instructions for the agent only.

Does Cy Orquestrate Issue access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cy Orquestrate Issue safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cy Orquestrate Issue use?

Cy Orquestrate Issue is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cy Orquestrate Issue use?

About 1.9k tokens (SKILL.md is roughly 7.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cy Orquestrate Issue?

Skills that share tags, products or a category with Cy Orquestrate Issue: Pre-Release PR Triage (jamiepine/voicebox, 57k stars), Codewhale Landing Workflow (codewhale-hq/Codewhale, 41k stars), Ff Worktrees (damus-io/damus, 2.1k stars) and Clean Complete Branches (jtenniswood/espcontrol, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cy Orquestrate Issue?

compozy (a GitHub organization) maintains it in compozy/compozy, which has 2,792 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on October 8, 2026.

Source: compozy/compozy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.