Skip to content
cccskills
FreePublished on GitHub

handle-issue

Work a GitHub issue in the octane repo. Use when given an issue number or link. Fetches the issue, classifies the owning area, and plans the fix.

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

Works withGitHub
See how to install

Files included (1)

  • SKILL.md2.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Skill: Handle an Octane GitHub issue

Use this to inspect an issue, triage it, propose a solution, and optionally implement it.

Inputs

  • Issue number or URL.
  • Optional scope constraints: triage-only, propose-only, implement, or create PR.

Workflow

  1. Fetch issue context

    gh issue view <number> --json number,title,body,author,labels,state,comments,assignees,milestone,url
    

    If linked PRs/commits are mentioned, inspect them too.

  2. Classify

    • bug, feature, docs, test gap, performance, parity gap, ecosystem binding, question.
    • affected area: core runtime, compiler, SSR/hydration, Vite plugin, binding package, benchmarks/docs.
    • severity and likely user impact.
  3. Check project rules

    • Read AGENTS.md, docs/packages.md, and relevant docs.
    • For React-behavior issues, check docs/differences-from-react.md and classify intentional divergence vs bug.
  4. Reproduce or validate claim

    • Prefer a minimal failing test or fixture.
    • If not reproducible, document missing info and ask targeted questions.
    • Avoid broad rewrites before there is a failing test.
  5. Propose solution Include:

    • root-cause hypothesis
    • files likely to change
    • test plan
    • compatibility/divergence considerations
    • risk level
  6. Optional implementation

    • Follow bug-hunter.md for bugs.
    • Follow octane-react-library-port for binding/compat issues.
    • Follow octane-core-extend.md for runtime/compiler extensions.
  7. Issue response template

Thanks: I triaged this as <classification> affecting <area>.

Findings:
- ...

Likely cause:
- ...

Proposed fix:
- ...

Validation plan:
- ...

Notes:
- ...
  1. Labels/comments
    • Use gh issue edit/gh issue comment only when asked or when operating autonomously with permission.
    • Do not close issues without maintainer instruction unless explicitly authorized.
    • Classify issues with the existing bug/enhancement/documentation/question set. The feat/fix/docs/test/perf/refactor/chore/ci type labels are for PRs.
    • Add agent-authored to an issue an agent filed. When an agent only comments on someone else's issue, say so in the comment rather than relabelling their issue.
    • A PR that closes the issue is labelled by create-a-pr, not here.

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

Write a new Octane component in .tsrx, convert JSX to .tsrx, or add scoped <style> blocks and themes. Use when creating a .tsrx file rather than editing one, because the path-scoped tsrx-authoring rule only fires once such a file is open.

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

octanejs/octane1.5KUpdated Oct 19, 2026

Find and fix a bug in the octane monorepo. Use when given a failing test, a regression, or a report that behavior differs from expectation, including deciding whether a React mismatch is an intentional divergence.

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

octanejs/octane1.5KUpdated Oct 19, 2026

Keep a change small and in the existing idiom - size the plan and weigh smaller alternatives before writing it, reuse the mechanism that already owns the behavior instead of adding a parallel one, and simplify the diff before handoff. Use when planning any change beyond a few lines, before readying a PR, or when reviewing agent-written code for bloat.

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

octanejs/octane1.5KUpdated Oct 19, 2026

Open a pull request for octane work. Load before creating the branch, commit, changeset, or PR, including when opening a PR is the tail step of a task that was about something else.

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

octanejs/octane1.5KUpdated Oct 19, 2026

Change Octane's runtime, compiler, scheduler, reconciler, SSR, or hydration engine. Use before editing packages/octane/src. Covers the observable contract, hot-path analysis, and the performance evidence required before handoff.

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

octanejs/octane1.5KUpdated Oct 19, 2026

Implement and verify new React-library ports or copied/rewritten React surfaces in Octane bindings from npm names or npm/GitHub links/lists. Enforces immutable provenance, license boundaries, dependency ordering, full-surface parity, and machine evidence. Existing-binding audits and maintenance start with update-bindings.

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

octanejs/octane1.5KUpdated Oct 19, 2026

See all skills by octanejs

Report a problem with this skill