Skip to content

rlaope/oh-my-hermes / .claude/agent-skills/omh-github-issue-intake

omh-github-issue-intake

Verified

[omh] Chat report that should become a GitHub issue: turn a public chat report into a confirmed, verified issue package.

Github Issue Intake

This is an OMH github-issue-intake workflow skill, projected for Agent Skills hosts (Claude Code, Codex, Cursor, opencode, OpenClaw, pi).

Why This Exists

github-issue-intake exists so a public support-chat report can become a verified GitHub issue through one bounded, confirmation-gated lane instead of ad hoc chat narration or an unscoped bot write.

Do Not Use When

  • The report only wants classification or signal clustering; use omh-feedback-triage instead.
  • The event concerns an already-existing issue, PR, review, or CI run; use omh-github-event-ops instead.
  • The user wants implementation; coding stays a separate follow-up lane with its own maintainer authority.
  • The report describes a security vulnerability; redirect to the private SECURITY.md path.

Examples

Good example:

  • Prompt: please file this as an issue: omh setup fails on Windows
  • Expected behavior: Classify the report, run the bounded interview, search duplicates, present the direction check, and prepare github_issue_intake/v1 for confirmation-gated connector handoff.
  • Why: The request is an explicit pre-creation filing ask with a classifiable report and an explicit target.

Bad example:

  • Prompt: github-issue-intake prove the issue was filed and labelled.
  • Expected behavior: Report that creation, labeling, and any GitHub mutation stay unobserved until an authorized connector returns read-back evidence.
  • Why: A prepared package is not issue creation, label application, or any GitHub mutation evidence.

Completion Checklist

  • github_issue_intake/v1 carries the report type, smallest outcome, scope, evidence versus inference, and the duplicate query with its result.
  • Confirmation was taken on the complete direction check before any connector handoff.
  • Creation is reported only with the connector's read-back URL; otherwise it is stated as prepared, not created.

Recovery Notes

  • If reproduction evidence is still missing after three questions, retain the report classification and observed facts, mark the direction unresolved, and hand back the missing steps, versions, or logs without filing.
  • If duplicate search cannot finish, retain the scoped report summary, mark duplicate status unresolved, and hand back the explicit repository and pending search; do not confirm or dispatch creation.
  • If connector read-back lacks request binding or issue fields, retain the confirmed direction and duplicate status, mark creation not_observed, and hand back the idempotency key and missing read-back fields without redispatching.

When to Use

Use when a public chat report should become a new GitHub issue: classify it, ask at most three decision-changing questions, search duplicates, confirm the direction, and hand the scoped creation to an authorized connector.

Strong routing signals: `github-issue-intake`, `github issue intake`, `issue intake`, `file this as an issue`, `file a github issue`, `open a github issue`, `create a github issue`, `submit a github issue`, `report a bug as an issue`, `new github issue`, `이슈로 올려줘`, `깃허브 이슈로 올려줘`, `이슈 등록해줘`, `깃허브 이슈 등록해줘`, `깃허브 이슈 만들어줘`, `깃허브 이슈 생성해줘`, `버그 리포트 올려줘`, `새 이슈 만들어줘`, `создай issue`, `заведи ишью`, `оформи как issue`, `зарепорть баг на гитхаб`, `сделай ишью на гитхабе`, `заведи issue на гитхабе`

Catalog Metadata

Category: github-ops Phase: issue-intake Quality tier: workflow-surface-gated Reasoning demand: standard

Quality bar:

  • Classify the report from supplied or observed facts and separate observation from inference.
  • Ask at most three unresolved, decision-changing questions; stop with a specific missing-evidence request instead of filing a vague issue.
  • Present the direction check, require confirmation, and keep prepared packages distinct from observed creation.
  • Search open and closed issues and PRs for duplicates (gh issue list --repo <r> --state all --search '<keywords> in:title,body' and the same with gh pr list, since gh issue list returns issues only), record the query and the top hits, and build the body from the matching .github/ISSUE_TEMPLATE/ form.

Required inputs:

  • public report or summary
  • source boundary
  • explicit target repository
  • desired outcome
  • scope boundary
  • missing evidence

Expert clarification questions:

  • desired outcome
    • English: What is the smallest user-visible outcome this issue should ask for?
    • Korean: 이 이슈가 요구해야 할 가장 작은 사용자 관점 결과는 무엇인가요?
  • scope boundary
    • English: What is explicitly included in this issue, and what is explicitly out of scope?
    • Korean: 이 이슈에 명시적으로 포함되는 범위와 명시적으로 제외되는 범위는 무엇인가요?
  • missing evidence
    • English: Which reproduction steps, versions, or logs are still missing and would change the issue direction?
    • Korean: 이슈 방향을 바꿀 수 있는 재현 단계, 버전, 로그 중 아직 없는 증거는 무엇인가요?

Expected outputs:

  • github_issue_intake/v1
  • direction check
  • duplicate status
  • issue package or connector handoff
  • read-back verification or explicit blocker

Artifact expectations:

  • github_issue_intake/v1 metadata-only wrapper card when recorded

Safety rules:

  • Investigation is read-only: repository and documentation exploration plus GitHub duplicate search; never mutate code, settings, branches, commits, PRs, releases, or deployments.
  • No external mutation before the direction check and an explicit confirmation; a maintainer file-now requires authenticated-wrapper actor/evidence identity and never bypasses duplicate, template, security, or read-back gates.
  • Confirmation requires a complete direction check - type, user-visible problem, source summary, smallest desired outcome, included and excluded scope, observed evidence versus inference, and duplicate status - plus a completed duplicate search; any blocker (security redirect, missing evidence, connector unavailable, or credentials missing) stops confirmation and handoff and cannot be cleared by a later observed result.
  • A public reporter authorizes exactly one scoped create_issue against an explicit repository; code, configuration, branch, commit, PR, merge, deployment, and coding-executor mutations stay in their own maintainer-gated lanes.
  • Security vulnerability reports redirect to the private SECURITY.md reporting path instead of a public issue. When the repository has no SECURITY.md and private vulnerability reporting is off (gh api repos/{owner}/{repo}/private-vulnerability-reporting), point the reporter to a private maintainer contact, file nothing publicly, and do not restate the exploit details in the reply.
  • Core OMH never calls GitHub; only a checked-in issue-form builder can produce an authorized create_issue request. An authorized connector receives one stable idempotency-keyed request, must enforce that key externally, and returns observed result evidence bound to that request; dispatch consumes the core handoff, so dispatched or observed artifacts cannot hand off again.
  • A prepared issue package is not creation evidence; only connector read-back of repository, author, title, body, labels, and URL is observed evidence.
  • The target repository must be explicit or safely configured; never infer a cross-repository target from context.
  • github_issue_intake/v1 persists bounded metadata, digests, and refs only: no raw title, body, transcript, platform event, credential, prompt, private log, or private content; the complete request remains transient for the connector.

Runtime Evidence

Use the current host's own tools and subagent/task mechanism when available; otherwise run the same lanes sequentially or name the unavailable capability. A prepared plan, handoff, checklist, or skill installation is not execution, review, CI, merge-readiness, or merge evidence. Record actual tool results, or not_observed / not_available, in the record; never invent dispatch or host accounting. Treat supplied context as advisory, not proof of hidden memory reads or writes. State scope, constraints, verification, and the stop condition before work. Reply in the user's own words and the host's own voice: the host's persona owns reply language, tone, speech level, and sentence endings, progress updates included (where it sets no language, use the one the user wrote in), and OMH shapes structure and content only; OMH's record terms (surface, lane, wrapper, handoff, evidence boundary, not_observed) stay in records and tool calls, never in the sentence the user reads unless they ask about one; and when a real unresolved user decision or a useful briefing discussion remains, offer one specific, content-linked question. Completed work needs no question; omit unrelated non-action footers and generic offers to continue. Supporting paths are relative to this skill directory; sibling skill paths are relative to its parent. Resolve them from the host-provided skill base directory ({baseDir} on hosts that provide it), never a hardcoded install location. A named workflow not installed here is unavailable, not permission to emulate its host-specific capabilities. Verify through the real surface before done.

receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 319kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 319kUpdated Claude CodeCodexVerifiedInstall