- GitHub Copilot
- Agent
- Intermediate
- GitHub Copilot
- ChatGPT
- Claude
- Published
Rewrite a Vague Issue into a Copilot Coding Agent-Ready Issue
Turns a vague GitHub issue into a self-contained task with context, testable acceptance criteria, files to touch, and tests to add, so the Copilot coding agent can finish it.
You get: Working code with an explanation
The prompt
mkdir -p .agents/skills/rewrite-a-vague-issue-into-a-copilot-coding-agent-ready-issue && curl -sL "https://prompts-gpt.com/prompts/rewrite-a-vague-issue-into-a-copilot-coding-agent-ready-issue/raw" -o .agents/skills/rewrite-a-vague-issue-into-a-copilot-coding-agent-ready-issue/SKILL.md---
name: rewrite-a-vague-issue-into-a-copilot-coding-agent-ready-issue
description: "Turns a vague GitHub issue into a self-contained task with context, testable acceptance criteria, files to touch, and tests to add, so the Copilot coding agent can finish it."
---
# Rewrite a Vague Issue into a Copilot Coding Agent-Ready Issue
Turns a vague GitHub issue into a self-contained task with context, testable acceptance criteria, files to touch, and tests to add, so the Copilot coding agent can finish it.
## Prompt
```
You are a maintainer preparing a GitHub issue to assign to the Copilot coding agent. The agent cannot ask questions mid-task, so the issue must stand alone. Here is the vague issue: {paste the vague issue here} Before writing, ask me one or two short questions if you need the repo layout, the test command, or the intended behavior. Rules: every acceptance criterion must be observable and pass or fail, such as a returned value, a status code, or a rendered state. Label file paths as confirmed or likely, and do not present guesses as facts. State what is out of scope. If the work is larger than one reviewable PR, propose a split into separate issues. Output exactly this: Title (imperative, under 80 characters). Context (why this matters and the current behavior). Desired behavior. Acceptance criteria as a checkbox list. Files to touch as a table with columns Path, Change, Confidence. Tests to add (name, input, expected result). Out of scope. How to verify (exact commands). Open questions for the maintainer. Finish with a one-line risk note on what could make the agent go wrong.
```
## Usage Notes
Use it before assigning an issue to Copilot. Paste the original issue text, and add a file tree or the test command if you have them.
You are a maintainer preparing a GitHub issue to assign to the Copilot coding agent. The agent cannot ask questions mid-task, so the issue must stand alone. Here is the vague issue: {paste the vague issue here} Before writing, ask me one or two short questions if you need the repo layout, the test command, or the intended behavior. Rules: every acceptance criterion must be observable and pass or fail, such as a returned value, a status code, or a rendered state. Label file paths as confirmed or likely, and do not present guesses as facts. State what is out of scope. If the work is larger than one reviewable PR, propose a split into separate issues. Output exactly this: Title (imperative, under 80 characters). Context (why this matters and the current behavior). Desired behavior. Acceptance criteria as a checkbox list. Files to touch as a table with columns Path, Change, Confidence. Tests to add (name, input, expected result). Out of scope. How to verify (exact commands). Open questions for the maintainer. Finish with a one-line risk note on what could make the agent go wrong.Example output
Tips and common edits
Use it before assigning an issue to Copilot. Paste the original issue text, and add a file tree or the test command if you have them.
Questions about this prompt
More like this
More in GitHub CopilotConventional Commit and PR Description from a Diff and Ticket
Produces a Conventional Commits message and a reviewer-ready PR description covering what changed, why, how to test it, and the risks, based on your diff and ticket.
Checkable Guardrail Rules for a Coding Agent: Blocked Commands, Approvals, Secrets and Hooks
Produces a set of testable guardrail rules for your coding agent, covering blocked commands, approval gates, secret handling and hook checks.
Coding Agent Task Brief with Guardrails, Test Plan, and Rollback Steps
Creates a scoped brief for an AI coding agent that limits file changes, defines tests, and includes a rollback plan and review checklist.
20-Case Agent Eval Set with Pass/Fail Rubric for Normal, Edge and Unsafe Requests
Builds 20 test cases for your agent's task, with expected behavior, failure signals and a pass/fail rubric covering normal, edge and unsafe requests.
Agent Tool Names, Descriptions and JSON Schemas from API Docs
Turns pasted API docs or a function list into agent-ready tool names, descriptions, JSON input schemas and when-to-use and when-not-to-use notes.
Agent Workflow Decomposition with Autonomy Levels and Stop Rules
Turns a manual process into a step-by-step agent plan with tools, approval gates, retry limits, and a build/pilot/skip recommendation.
Characterization Tests Before a Refactor
Writes tests that lock in a module's current behavior, including edge cases and quirks, so you can refactor safely.
Codebase Tour for a Specific Task
Explores a repo through the lens of your task and explains the architecture, key files and data flow, then says where to start.
Failing Test First Bug Fix
Reproduces a bug with a failing test, finds the root cause, applies the smallest fix and shows the test passing.
Parallel Research Fan-Out and Fan-In with Citation Table and Decision Memo
Splits a research question across parallel research agents, defines source discovery and evidence review steps, merges findings into a citation table, and produces a decision memo without claiming live browsing.
Research Agent Brief: Source Discovery, Evidence Review, and Citation Table
Directs an AI agent to plan source discovery, grade evidence, build a citation table, and support a decision without claiming live browsing occurred.
Research-to-Report Pipeline with Planner, Researcher, Writer and Fact-Checker
Designs a four-agent pipeline for your report type with each agent's prompt, inputs, outputs and handoff format.