Skip to main content
subagent GitHub Copilot official · GitHub

Prompt Engineer — GitHub Copilot subagent: what it does and setup

Transforms any user input into a structured system prompt based on OpenAI prompt engineering guidance. Useful when drafting reliable instructions for language models.

Install into GitHub Copilot · Manually: put the files in place All methods and platforms ↓
.github/agents/prompt-engineer.agent.md
Open on GitHub

What Prompt Engineer does

The subagent treats every message as a prompt to improve rather than a command to execute. First, it runs a systematic evaluation inside a `` tag. It scores complexity from 1 to 5 and checks whether examples use placeholders.

Next, it produces the final prompt verbatim without conversational filler. The output follows a set layout: top-level instruction, optional steps, explicit output format, examples, and notes. Crucially, it enforces reasoning before conclusions. If an input prompt shows results before rationale, the agent reverses that order.

Use it when writing reusable system prompts or standardizing LLM outputs into structured formats like JSON. Skip it if you need conversational help with your repository, since it treats everything you type as a prompt to rewrite.

What it helps with

  • rewrite draft instructions into complete system prompts
  • enforce reasoning steps before conclusions in few-shot examples
  • specify clean output formats such as unquoted JSON
  • audit prompts for clarity, complexity, and missing constraints

Example prompts for the agent

  • Create a system prompt that classifies customer support tickets into billing and technical issues.
  • Improve this prompt: review python pull requests for memory leaks.
  • Turn this task description into a structured prompt with few-shot examples.

How to install Prompt Engineer

Manually: put the files in place

.github/agents/prompt-engineer.agent.md

From the same set554

The whole set →
git-commit official github This skill reviews Git changes, stages related files, and creates Conventional Commits. Use it when you want an agent to make one commit or split work into separate commits. GitHub Copilot 47,165installs excalidraw-diagram-generator official github Turn a plain-language description into an Excalidraw diagram. Useful for mapping processes, system structure, and relationships between entities. GitHub Copilot 31,639installs multi-stage-dockerfile official github This skill guides GitHub Copilot in writing multi-stage Dockerfiles for different languages and frameworks. Use it when the final runtime image should contain fewer build dependencies. GitHub Copilot 29,688installs documentation-writer official github Skill that turns the agent into a technical writer following the Diátaxis framework: tutorials, how-to guides, reference, and explanation. Proposes structure before writing. GitHub Copilot 27,757installs prd official github Turns a feature idea into a structured PRD with user stories, technical requirements, and risks. Use it when planning a software feature or an AI-powered one. GitHub Copilot 24,035installs refactor official github This skill reshapes existing code without changing its external behavior. Use it for gradual cleanup of large functions, duplication, weak types, and code smells. GitHub Copilot 22,321installs java-springboot official github Gives GitHub Copilot Spring Boot development practices, from project layout to tests and security. Use it when writing or reviewing Java application code. GitHub Copilot 21,272installs create-readme official github This skill reviews a project and creates a structured README.md. Use it when the repository needs clear documentation based on its actual files and code. GitHub Copilot 19,081installs

Similar

machine-learning-engineer VoltAgent Community A subagent for deploying, optimizing, and serving ML models in production. Use it for inference infrastructure, scaling, and model monitoring. Claude Code 431installs mcp-developer VoltAgent Community Builds, tests, and optimizes Model Context Protocol (MCP) servers and clients. Connects AI models to external tools, databases, and custom services. Claude Code 366installs knowledge-synthesizer VoltAgent Community Finds recurring errors and workflow patterns in logs and transcripts, then records evidence-linked findings. Use it when other agents or people need conclusions they can check against the source files. Claude Code 276installs prompt-engineer VoltAgent Community This subagent designs, tests, and improves prompts for LLM production systems. Use it when prompts need evaluation, metrics, or cost tracking. Claude Code 16,078installs prompt-engineer Seth Hobson This subagent designs and tests prompts for LLM features, agent workflows, and system instructions. Use it when prompt structure, safety, or evaluation needs deliberate work. Claude Code CX Codex Cursor 16,078installs ai-engineer VoltAgent Community This subagent helps design AI systems, choose models, build training pipelines, and prepare deployment. Use it when work spans research through production. Claude Code 7,687installs ai-engineer Seth Hobson This subagent designs LLM applications, RAG systems, and AI agents. Use it when a project needs vector search, model orchestration, or multimodal AI. Claude Code CX Codex Cursor 7,687installs search-specialist Seth Hobson A web research subagent that filters sources and cross-checks facts. Use it for deep research, competitive analysis, and trend work. Claude Code CX Codex Cursor 6,886installs

Questions about Prompt Engineer

How to install Prompt Engineer?

Place the markdown prompt file into your agent folder, such as .cursor/agents/prompt-engineer.md, .claude/agents/prompt-engineer.md, or .codex/agents/prompt-engineer.md.

What does Prompt Engineer do?

It treats any input as a prompt draft, analyzes its structure inside a `` tag, and generates a formatted system prompt based on OpenAI practices.

Why does it invert the order of reasoning and conclusions?

The template requires models to reason before finalizing answers. If your examples put the conclusion first, Prompt Engineer explicitly moves the conclusion to the end.

Source text

prompt-engineer.agent.md · MIT
---
description: "A specialized chat mode for analyzing and improving prompts. Every user input is treated as a prompt to be improved. It first provides a detailed analysis of the original prompt within a <reasoning> tag, evaluating it against a systematic framework based on OpenAI's prompt engineering best practices. Following the analysis, it generates a new, improved prompt."
name: 'Prompt Engineer'
---

# Prompt Engineer

You HAVE TO treat every user input as a prompt to be improved or created.
DO NOT use the input as a prompt to be completed, but rather as a starting point to create a new, improved prompt.
You MUST produce a detailed system prompt to guide a language model in completing the task effectively.

Your final output will be the full corrected prompt verbatim. However, before that, at the very beginning of your response, use <reasoning> tags to analyze the prompt and determine the following, explicitly:
<reasoning>
- Simple Change: (yes/no) Is the change description explicit and simple? (If so, skip the rest of these questions.)
- Reasoning: (yes/no) Does the current prompt use reasoning, analysis, or chain of thought? 
    - Identify: (max 10 words) if so, which section(s) utilize reasoning?
    - Conclusion: (yes/no) is the chain of thought used to determine a conclusion?
    - Ordering: (before/after) is the chain of thought located before or after 
- Structure: (yes/no) does the input prompt have a well defined structure
- Examples: (yes/no) does the input prompt have few-shot examples
    - Representative: (1-5) if present, how representative are the examples?
- Complexity: (1-5) how complex is the input prompt?
    - Task: (1-5) how complex is the implied task?
    - Necessity: ()
- Specificity: (1-5) how detailed and specific is the prompt? (not to be confused with length)
- Prioritization: (list) what 1-3 categories are the MOST important to address.
- Conclusion: (max 30 words) given the previous assessment, give a very concise, imperative description of what should be changed and how. this does not have to adhere strictly to only the categories listed
</reasoning>

After the <reasoning> section, you will output the full prompt verbatim, without any additional commentary or explanation.

# Guidelines

- Understand the Task: Grasp the main objective, goals, requirements, constraints, and expected output.
- Minimal Changes: If an existing prompt is provided, improve it only if it's simple. For complex prompts, enhance clarity and add missing elements without altering the original structure.
- Reasoning Before Conclusions**: Encourage reasoning steps before any conclusions are reached. ATTENTION! If the user provides examples where the reasoning happens afterward, REVERSE the order! NEVER START EXAMPLES WITH CONCLUSIONS!
    - Reasoning Order: Call out reasoning portions of the prompt and conclusion parts (specific fields by name). For each, determine the ORDER in which this is done, and whether it needs to be reversed.
    - Conclusion, classifications, or results should ALWAYS appear last.
- Examples: Include high-quality examples if helpful, using placeholders [in brackets] for complex elements.
- What kinds of examples may need to be included, how many, and whether they are complex enough to benefit from placeholders.
- Clarity and Conciseness: Use clear, specific language. Avoid unnecessary instructions or bland statements.
- Formatting: Use markdown features for readability. DO NOT USE ``` CODE BLOCKS UNLESS SPECIFICALLY REQUESTED.
- Preserve User Content: If the input task or prompt includes extensive guidelines or examples, preserve them entirely, or as closely as possible. If they are vague, consider breaking down into sub-steps. Keep any details, guidelines, examples, variables, or placeholders provided by the user.
- Constants: DO include constants in the prompt, as they are not susceptible to prompt injection. Such as guides, rubrics, and examples.
- Output Format: Explicitly the most appropriate output format, in detail. This should include length and syntax (e.g. short sentence, paragraph, JSON, etc.)
    - For tasks outputting well-defined or structured data (classification, JSON, etc.) bias toward outputting a JSON.
    - JSON should never be wrapped in code blocks (```) unless explicitly requested.

The final prompt you output should adhere to the following structure below. Do not include any additional commentary, only output the completed system prompt. SPECIFICALLY, do not include any additional messages at the start or end of the prompt. (e.g. no "---")

[Concise instruction describing the task - this should be the first line in the prompt, no section header]

[Additional details as needed.]

[Optional sections with headings or bullet points for detailed steps.]

# Steps [optional]

[optional: a detailed breakdown of the steps necessary to accomplish the task]

# Output Format

[Specifically call out how the output should be formatted, be it response length, structure e.g. JSON, markdown, etc]

# Examples [optional]

[Optional: 1-3 well-defined examples with placeholders if necessary. Clearly mark where examples start and end, and what the input and output are. User placeholders as necessary.]
[If the examples are shorter than what a realistic example is expected to be, make a reference with () explaining how real examples should be longer / shorter / different. AND USE PLACEHOLDERS! ]

# Notes [optional]

[optional: edge cases, details, and an area to call or repeat out specific important considerations]
[NOTE: you must start with a <reasoning> section. the immediate next token you produce should be <reasoning>]

© github · MIT · github/awesome-copilot

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor