# Ki Work Github Issues

> Define GitHub Issues configuration, lifecycle mapping, hierarchy, dependencies, review, closure, and remote-write safety as a KI work adapter. Use when GitHub Issues is selected; remote execution is unavailable, while local files use `ki-work-roadmap` and Linear uses `ki-work-linear`.

- Skill: `knowledgeislands/ki-work-github-issues-2` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx get-skill add knowledgeislands/ki-work-github-issues-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/knowledgeislands/ki-work-github-issues-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: knowledgeislands (https://skillmd.com/u/knowledgeislands)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/knowledgeislands/ki-work-github-issues-2

---


# KI GitHub Issues change management

This skill configures and explains one GitHub repository's Issues as a future forward-work adapter. It does not mirror Issues into a local roadmap, resolve remote work for a process, or make remote writes. No remote executor is implemented, so a shared process selecting this adapter stops rather than guessing a local path or GitHub operation.

`<owner>/<repository>#<number>` is the **current mutable locator**, not durable cross-transfer identity. GitHub can transfer an open Issue, changing its repository namespace and potentially its number; retain the prior locator as historical alias evidence and re-resolve the current locator before any future operation.

Read [the GitHub Issues adapter standard](references/standards-github-issues.md) before configuring or operating the adapter. Read [the generated rubric](references/rubric.md) for the checkable configuration contract.

Its root declaration is the repository-local selection signal `ki-repo` uses to require the GitHub Issues feature and canonical `package.json` `bugs` URL. Repositories without this declaration keep Issues disabled and omit that package field.

## Operating modes

Carries the universal **AUDIT · CONFORM · EDUCATE · REFRESH** modes. `help` / `-h` / `?` describes the adapter and stops.

### Mode AUDIT

Run `ki repo audit --skill ki-work-github-issues --repo <repo>`. It verifies the declared GitHub repository, required lifecycle metadata mapping, and rejects undeclared keys. It cannot confirm remote authentication, repository access, Issue-versus-pull-request filtering, current locators, or remote metadata; AUDIT never calls GitHub.

### Mode CONFORM

Run `ki repo conform --skill ki-work-github-issues --repo <repo> --dry-run`. It has no remote operation and proposes no remote mutation. It never creates, edits, closes, labels, transfers, archives, or deletes an Issue.

### Mode EDUCATE

Explain the configuration, lifecycle metadata mapping, mutable-locator migration stop, and no-remote-execution boundary. Do not route a shared process through GitHub until an authorised remote resolver and executor exist.

### Mode REFRESH

**Precondition:** REFRESH writes only this canonical skill in `ki-agent-backpack`. From an installed copy, stop and redirect to the Harness. Re-fetch every primary source in [the source record](references/sources.md) when GitHub changes Issue identity, transfer, fields, hierarchy, dependency, closure, permissions, or API semantics, or when the common lifecycle gains a state that cannot be mapped without ambiguity.

