# Create Spike

Investigate an OpenShell problem and create a structured issue with technical findings...

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

## Install

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

## Description

Investigate an OpenShell problem and create a structured issue with technical findings for human disposition.

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

# Create Spike

Investigate a specific OpenShell need and record the findings in a GitHub issue. Use `create-github-issue` for the issue structure and `triage-issue` for the distinction between technical validation and human acceptance. A spike does not authorize implementation or a roadmap decision.

## Before investigating

Ask the human operator to attest that they personally use OpenShell and directly encountered the problem or need the feature for a specific use case. If that context is absent, request it before creating the issue. Do not invent a user story or file a generic platform wish as their first-hand need. Search existing issues to avoid duplication. Follow `SECURITY.md` for suspected vulnerabilities instead of filing a public issue.

## Investigate

1. Reconstruct the current OpenShell workflow and the claimed gap. For a bug, use reproduction steps requiring only OpenShell deployments; do not install third-party tools solely to demonstrate it.
2. Explore the relevant code and tests. Separate observed behavior, likely cause, and open questions. If the claim cannot be validated, state the exact missing evidence.
3. For a feature, describe the desired external behavior and evaluate alternatives, including relevant middleware, interceptors, providers, or other extension points. Prefer an applicable extension when it satisfies the use case; the need to run another service alone does not disqualify it.
4. For configuration, CLI, SDK, or other UX changes, include notional commands, configuration, or API examples for human review. Leave internal implementation choices open unless they are essential constraints.

## Record the result

The rest: https://github.com/NVIDIA/OpenShell/blob/HEAD/.agents/skills/create-spike/SKILL.md