Skills reference and input options.
Every issuedev / gitissue command in one place: what it does, accepted inputs, execution modes, and requirements.
Quick map
Slash commands are the public interface. Natural-language requests may trigger the same skills when your agent supports skill discovery.
/init-gitissue
Generate repository config.
/issue-creator
Create, normalize, or batch-create issues.
/issue-analysis
Deep analysis for one issue.
/issue-triage
Prioritize and order the backlog.
/issue-resolver
Resolve one issue into an atomic PR.
/issue-pr-review
Review a PR, fix, test, and check CI.
/auto-pilot
Run the autonomous backlog loop.
/idd-doctor
Read-only repo health check.
/init-gitissue
Detects language, framework, test runner, and repo size, then writes .gitissue.yml.
| Input | Mode | Behavior |
|---|---|---|
| /init-gitissue | Generate config | Creates config when missing. If it exists, offers overwrite, merge, or cancel. |
Requires git only. No GitHub CLI authentication needed.
/issue-creator
Captures durable human intent as structured GitHub issues. It does not guess affected files, root cause, or implementation details.
| Input | Mode | Behavior |
|---|---|---|
| /issue-creator <text> | Create | Creates one structured issue from a plain-text description. |
| /issue-creator <N> | Normalize | Rewrites existing issue #N into the standard template. |
| /issue-creator <N> --dry-run | Preview | Shows the normalized body without applying it. |
| /issue-creator <N> --force | Force | Normalizes even when security-sensitive labels would normally block. |
| /issue-creator <multi-item text> | Batch | Extracts multiple distinct issues and creates them sequentially. |
| /issue-creator <image path> [text] | Image | Reads visual context, uploads supported images, and embeds them in the issue. |
Supported images: PNG, JPG/JPEG, GIF, WEBP, SVG up to 10 MB. Requires authenticated gh.
/issue-analysis
Analyzes one issue for root cause, architecture impact, implementation options, complexity, and risk.
| Input | Mode | Behavior |
|---|---|---|
| /issue-analysis <N> | Full analysis | Fetches issue #N, scans the codebase, and writes .gitissue/analysis-N.json. |
| /issue-analysis <N> view | Cached view | Renders the cached JSON without rescanning or calling GitHub. |
/issue-triage
Ranks open issues, detects dependencies, highlights parallel work, flags stale items, and finds already-fixed signals.
| Input | Mode | Behavior |
|---|---|---|
| /issue-triage | Cached view | Shows .gitissue/triage.json. If no cache exists, runs the first analysis. |
| /issue-triage update | Full update | Re-analyzes open issues and overwrites the cache. |
| /issue-triage --limit N | Limited update | Analyzes up to N issues. |
/issue-resolver
Resolves one GitHub issue end-to-end: research, plan, implement, QA, and PR creation.
| Input | Mode | Behavior |
|---|---|---|
| /issue-resolver <N> | Interactive | Asks the user to pick an implementation plan, then implements and opens a PR. |
| /issue-resolver <N> --auto | Auto-pilot | Runs autonomously with no user prompts. |
Requires git, authenticated gh, a GitHub remote, and push access.
/issue-pr-review
Reviews an existing PR with a script pre-pass, five-dimension review, tests/build, CI, and a fix loop. Default mode fixes and repeats; auto-merge only happens with --auto.
| Input | Mode | Behavior |
|---|---|---|
| /issue-pr-review <N> | Interactive fix loop | Reviews PR #N, fixes action: fix issues, repeats until clean or stopped, and reports. No auto-merge. |
| /issue-pr-review <N> --auto | Auto-pilot | Reviews, fixes, waits for CI, and auto-merges when clean. |
| /issue-pr-review | Detect PR | Auto-detects the PR for the current branch and runs the default fix loop. |
| /issue-pr-review --review-only | Read-only | Runs one pass, reports findings, and never edits, loops, pushes, or merges. |
The fix loop stops when no fix issues remain, tests and CI pass, traceability and acceptance criteria are not failing, max cycles are reached, stagnation is detected, or a blocking operational error occurs.
/auto-pilot
Runs the full IDD loop over the backlog: triage, pick, resolve, review, fix, merge, repeat.
| Input | Behavior |
|---|---|
| /auto-pilot | Process the open backlog according to triage order. |
| /auto-pilot --issues 5,10,12 | Process only those issues in that exact order. |
| /auto-pilot --limit N | Process at most N issues. |
| /auto-pilot --dry-run | Show the execution plan without resolving anything. |
| /auto-pilot --skip N | Skip issue #N for this session. |
--issues can combine with --dry-run and --skip, but not --limit.
/idd-doctor
Read-only health check for this IDD repository. It never modifies files, issues, PRs, or comments.
| Input | Mode | Behavior |
|---|---|---|
| /idd-doctor | Report only | Checks stale issue-creator claims, forbidden issue-template fields, missing autopilot.mode, and squash-merge defaults. |
Requires git. gh is optional; without it, merge-strategy checking is skipped.
Choosing the right skill
| Goal | Use |
|---|---|
| First-time setup | /init-gitissue |
| Create a structured issue | /issue-creator <text> |
| Normalize an issue | /issue-creator <N> |
| Analyze one issue | /issue-analysis <N> |
| Prioritize the backlog | /issue-triage update |
| Implement one issue | /issue-resolver <N> |
| Review and clean a PR | /issue-pr-review <PR> |
| Audit a PR without edits | /issue-pr-review <PR> --review-only |
| Process the backlog autonomously | /auto-pilot |