# Build from GitHub Issue

Plans and implements a GitHub issue with verification, docs and a closing PR.

- Repository: https://github.com/NVIDIA/OpenShell (20903 stars)
- Category: Git and review
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add NVIDIA/OpenShell --skill build-from-issue -g -a claude-code -y`
Codex: `npx skills add NVIDIA/OpenShell --skill build-from-issue -g -a codex -y`
Cursor: `npx skills add NVIDIA/OpenShell --skill build-from-issue -g -a cursor -y`
Gemini CLI: `npx skills add NVIDIA/OpenShell --skill build-from-issue -g -a gemini-cli -y`

## Description

Plan and implement work described in a GitHub issue, including verification, documentation, and a PR that closes the issue.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Build From Issue

Use a specific GitHub issue to plan and implement a scoped change. Direct user instructions authorize the phase requested. Planning alone does not authorize implementation. For unattended work, inspect the current `state:*` label descriptions, maintainer assignments, and issue comments to infer the authorized phase. Proceed only when those records authorize the phase; do not assume every state permits implementation.

## Inspect the issue

1. Run `gh issue view <id> --json number,title,body,state,labels,comments,assignees` and follow Label Discovery in `CONTRIBUTING.md` to retrieve every page of current `state:*` label definitions and resolve unclear meanings. Infer whether triage, validation, and human acceptance have happened. Do not hard-code label names or change disposition as part of building.
2. Read the issue, comments, linked PRs, and current code. Check for an active owner or implementation. If the issue concerns a vulnerability, use `review-security-issue` and `fix-security-issue` instead.
3. Confirm that the User Story attests to the human operator's first-hand OpenShell use and gives a specific use case. If the issue lacks this, ask the operator before proceeding with planning or implementation. For a bug, require reproduction using only an OpenShell deployment; do not install third-party tools solely to demonstrate the problem.
4. If the user's direct request starts before the normal issue disposition, briefly report the discrepancy and continue with the authorized phase. Stop only when information needed to do the work is actually unavailable or a conflicting owner needs resolution.

## Plan

The rest: https://github.com/NVIDIA/OpenShell/blob/HEAD/.agents/skills/build-from-issue/SKILL.md