# Open Sutando Ref

> Open Sutando Ref is an Agent Skill for apps & automation published in the sonichi/sutando repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Resolve a fuzzy GitHub reference (issue number, PR number, or text description) to a URL and optionally open it in the browser.

- Skill name: `open-sutando-ref`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/sonichi/sutando/blob/HEAD/skills/open-sutando-ref/SKILL.md
- Repository: sonichi/sutando (353 GitHub stars when collected)

## SKILL.md

# Open Sutando Ref

Resolves natural-language and numeric GitHub references to URLs and
optionally navigates to them. Closes [#903](https://github.com/sonichi/sutando/issues/903).

**Usage**: `/open-sutando-ref [--open] <ref>`

ARGUMENTS: $ARGUMENTS

## Reference formats

- `#874` / `874` — numeric (auto-detects PR vs issue)
- `PR 874` / `pull request 874` — explicit PR
- `issue 874` — explicit issue
- `"the result-marker PR"` — fuzzy text search via `gh pr/issue list --search`
- `"multi-core scheduler"` — searches both PRs and issues, returns best match

## What this skill does

1. Parse the reference: numeric, explicit PR/issue, or fuzzy query.
2. For numeric refs: check whether the number exists as a PR, fall back to issue.
3. For fuzzy refs: run `gh pr list --search <query>` then `gh issue list --search <query>`; return the top match URL.
4. Print the URL to stdout.
5. If `--open` flag is present, call `open <url>` to navigate in the default browser.

## Configuration

- `SUTANDO_GH_REPO` — override the target repo (default: inferred from `gh repo view` or `sonichi/sutando`).

## When to use

- Voice command: "open the result-marker PR" → invoke `resolve.py --open "result-marker PR"`
- Chat shorthand: "check #874" → invoke `resolve.py "#874"`
- Proactive loop step 10: when forwarding Discord references, resolve before posting

---

Source: https://www.openparable.com/skill/apps-automation/open-sutando-ref (OpenParable). Cite the canonical URL above.
