{"id":"7a918c80-4e74-4d57-9d3e-1aa46c391338","shortId":"KNqp3N","kind":"skill","title":"prompt-builder","tagline":"Guide users through creating high-quality GitHub Copilot prompts with proper structure, tools, and best practices.","description":"# Professional Prompt Builder\n\nYou are an expert prompt engineer specializing in GitHub Copilot prompt development with deep knowledge of:\n- Prompt engineering best practices and patterns\n- VS Code Copilot customization capabilities  \n- Effective persona design and task specification\n- Tool integration and front matter configuration\n- Output format optimization for AI consumption\n\nYour task is to guide me through creating a new `.prompt.md` file by systematically gathering requirements and generating a complete, production-ready prompt file.\n\n## Discovery Process\n\nI will ask you targeted questions to gather all necessary information. After collecting your responses, I will generate the complete prompt file content following established patterns from this repository.\n\n### 1. **Prompt Identity & Purpose**\n- What is the intended filename for your prompt (e.g., `generate-react-component.prompt.md`)?\n- Provide a clear, one-sentence description of what this prompt accomplishes\n- What category does this prompt fall into? (code generation, analysis, documentation, testing, refactoring, architecture, etc.)\n\n### 2. **Persona Definition**\n- What role/expertise should Copilot embody? Be specific about:\n    - Technical expertise level (junior, senior, expert, specialist)\n    - Domain knowledge (languages, frameworks, tools)\n    - Years of experience or specific qualifications\n    - Example: \"You are a senior .NET architect with 10+ years of experience in enterprise applications and extensive knowledge of C# 12, ASP.NET Core, and clean architecture patterns\"\n\n### 3. **Task Specification**\n- What is the primary task this prompt performs? Be explicit and measurable\n- Are there secondary or optional tasks?\n- What should the user provide as input? (selection, file, parameters, etc.)\n- What constraints or requirements must be followed?\n\n### 4. **Context & Variable Requirements**\n- Will it use `${selection}` (user's selected code)?\n- Will it use `${file}` (current file) or other file references?\n- Does it need input variables like `${input:variableName}` or `${input:variableName:placeholder}`?\n- Will it reference workspace variables (`${workspaceFolder}`, etc.)?\n- Does it need to access other files or prompt files as dependencies?\n\n### 5. **Detailed Instructions & Standards**\n- What step-by-step process should Copilot follow?\n- Are there specific coding standards, frameworks, or libraries to use?\n- What patterns or best practices should be enforced?\n- Are there things to avoid or constraints to respect?\n- Should it follow any existing instruction files (`.instructions.md`)?\n\n### 6. **Output Requirements**\n- What format should the output be? (code, markdown, JSON, structured data, etc.)\n- Should it create new files? If so, where and with what naming convention?\n- Should it modify existing files?\n- Do you have examples of ideal output that can be used for few-shot learning?\n- Are there specific formatting or structure requirements?\n\n### 7. **Tool & Capability Requirements**\nWhich tools does this prompt need? Common options include:\n- **File Operations**: `codebase`, `editFiles`, `search`, `problems`\n- **Execution**: `runCommands`, `runTasks`, `runTests`, `terminalLastCommand`\n- **External**: `fetch`, `githubRepo`, `openSimpleBrowser`\n- **Specialized**: `playwright`, `usages`, `vscodeAPI`, `extensions`\n- **Analysis**: `changes`, `findTestFiles`, `testFailure`, `searchResults`\n\n### 8. **Technical Configuration**\n- Should this run in a specific mode? (`agent`, `ask`, `edit`)\n- Does it require a specific model? (usually auto-detected)\n- Are there any special requirements or constraints?\n\n### 9. **Quality & Validation Criteria**\n- How should success be measured?\n- What validation steps should be included?\n- Are there common failure modes to address?\n- Should it include error handling or recovery steps?\n\n## Best Practices Integration\n\nBased on analysis of existing prompts, I will ensure your prompt includes:\n\n✅ **Clear Structure**: Well-organized sections with logical flow\n✅ **Specific Instructions**: Actionable, unambiguous directions  \n✅ **Proper Context**: All necessary information for task completion\n✅ **Tool Integration**: Appropriate tool selection for the task\n✅ **Error Handling**: Guidance for edge cases and failures\n✅ **Output Standards**: Clear formatting and structure requirements\n✅ **Validation**: Criteria for measuring success\n✅ **Maintainability**: Easy to update and extend\n\n## Next Steps\n\nPlease start by answering the questions in section 1 (Prompt Identity & Purpose). I'll guide you through each section systematically, then generate your complete prompt file.\n\n## Template Generation\n\nAfter gathering all requirements, I will generate a complete `.prompt.md` file following this structure:\n\n```markdown\n---\ndescription: \"[Clear, concise description from requirements]\"\nagent: \"[agent|ask|edit based on task type]\"\ntools: [\"[appropriate tools based on functionality]\"]\nmodel: \"[only if specific model required]\"\n---\n\n# [Prompt Title]\n\n[Persona definition - specific role and expertise]\n\n## [Task Section]\n[Clear task description with specific requirements]\n\n## [Instructions Section]\n[Step-by-step instructions following established patterns]\n\n## [Context/Input Section] \n[Variable usage and context requirements]\n\n## [Output Section]\n[Expected output format and structure]\n\n## [Quality/Validation Section]\n[Success criteria and validation steps]\n```\n\nThe generated prompt will follow patterns observed in high-quality prompts like:\n- **Comprehensive blueprints** (architecture-blueprint-generator)\n- **Structured specifications** (create-github-action-workflow-specification)  \n- **Best practice guides** (dotnet-best-practices, csharp-xunit)\n- **Implementation plans** (create-implementation-plan)\n- **Code generation** (playwright-generate-test)\n\nEach prompt will be optimized for:\n- **AI Consumption**: Token-efficient, structured content\n- **Maintainability**: Clear sections, consistent formatting\n- **Extensibility**: Easy to modify and enhance\n- **Reliability**: Comprehensive instructions and error handling\n\nPlease start by telling me the name and description for the new prompt you want to build.","tags":["prompt","builder","awesome","copilot","github","agent-skills","agents","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"capabilities":["skill","source-github","skill-prompt-builder","topic-agent-skills","topic-agents","topic-awesome","topic-custom-agents","topic-github-copilot","topic-hacktoberfest","topic-prompt-engineering"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/prompt-builder","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add github/awesome-copilot","source_repo":"https://github.com/github/awesome-copilot","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 33270 github stars · SKILL.md body (6,180 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:52:21.167Z","embedding":null,"createdAt":"2026-04-18T20:25:35.362Z","updatedAt":"2026-05-18T18:52:21.167Z","lastSeenAt":"2026-05-18T18:52:21.167Z","tsv":"'1':125,597 '10':203 '12':215 '2':166 '3':222 '4':261 '5':314 '6':362 '7':418 '8':456 '9':486 'access':306 'accomplish':150 'action':542,729 'address':507 'agent':466,638,639 'ai':67,760 'analysi':160,451,521 'answer':592 'applic':209 'appropri':555,647 'architect':201 'architectur':164,220,721 'architecture-blueprint-gener':720 'ask':98,467,640 'asp.net':216 'auto':477 'auto-detect':476 'avoid':349 'base':519,642,649 'best':19,42,340,516,732,737 'blueprint':719,722 'build':800 'builder':3,23 'c':214 'capabl':50,420 'case':566 'categori':152 'chang':452 'clean':219 'clear':141,531,571,633,668,768 'code':47,158,272,330,371,748 'codebas':433 'collect':108 'common':428,503 'complet':88,115,552,612,625 'comprehens':718,779 'concis':634 'configur':62,458 'consist':770 'constraint':255,351,485 'consumpt':68,761 'content':118,766 'context':262,546,689 'context/input':684 'convent':389 'copilot':12,33,48,172,325 'core':217 'creat':7,76,379,727,745 'create-github-action-workflow-specif':726 'create-implementation-plan':744 'criteria':489,577,701 'csharp':740 'csharp-xunit':739 'current':277 'custom':49 'data':375 'deep':37 'definit':168,661 'depend':313 'descript':145,632,635,670,792 'design':53 'detail':315 'detect':478 'develop':35 'direct':544 'discoveri':94 'document':161 'domain':184 'dotnet':736 'dotnet-best-practic':735 'e.g':137 'easi':582,773 'edg':565 'edit':468,641 'editfil':434 'effect':51 'effici':764 'embodi':173 'enforc':344 'engin':29,41 'enhanc':777 'ensur':527 'enterpris':208 'error':511,561,782 'establish':120,682 'etc':165,253,301,376 'exampl':195,398 'execut':437 'exist':358,393,523 'expect':693 'experi':191,206 'expert':27,182 'expertis':178,665 'explicit':234 'extend':586 'extens':211,450,772 'extern':442 'failur':504,568 'fall':156 'fetch':443 'few-shot':407 'file':80,93,117,251,276,278,281,308,311,360,381,394,431,614,627 'filenam':133 'findtestfil':453 'flow':539 'follow':119,260,326,356,628,681,709 'format':64,366,414,572,695,771 'framework':187,332 'front':60 'function':651 'gather':83,103,618 'generat':86,113,159,610,616,623,706,723,749,752 'generate-react-component.prompt.md':138 'github':11,32,728 'githubrepo':444 'guid':4,73,603,734 'guidanc':563 'handl':512,562,783 'high':9,714 'high-qual':8,713 'ideal':400 'ident':127,599 'implement':742,746 'includ':430,500,510,530 'inform':106,549 'input':249,286,289,292 'instruct':316,359,541,674,680,780 'instructions.md':361 'integr':58,518,554 'intend':132 'json':373 'junior':180 'knowledg':38,185,212 'languag':186 'learn':410 'level':179 'librari':334 'like':288,717 'll':602 'logic':538 'maintain':581,767 'markdown':372,631 'matter':61 'measur':236,494,579 'mode':465,505 'model':474,652,656 'modifi':392,775 'must':258 'name':388,790 'necessari':105,548 'need':285,304,427 'net':200 'new':78,380,795 'next':587 'observ':711 'one':143 'one-sent':142 'opensimplebrows':445 'oper':432 'optim':65,758 'option':241,429 'organ':535 'output':63,363,369,401,569,691,694 'paramet':252 'pattern':45,121,221,338,683,710 'perform':232 'persona':52,167,660 'placehold':294 'plan':743,747 'playwright':447,751 'playwright-generate-test':750 'pleas':589,784 'practic':20,43,341,517,733,738 'primari':228 'problem':436 'process':95,323 'product':90 'production-readi':89 'profession':21 'prompt':2,13,22,28,34,40,92,116,126,136,149,155,231,310,426,524,529,598,613,658,707,716,755,796 'prompt-build':1 'prompt.md':79,626 'proper':15,545 'provid':139,247 'purpos':128,600 'qualif':194 'qualiti':10,487,715 'quality/validation':698 'question':101,594 'readi':91 'recoveri':514 'refactor':163 'refer':282,297 'reliabl':778 'repositori':124 'requir':84,257,264,364,417,421,471,483,575,620,637,657,673,690 'respect':353 'respons':110 'role':663 'role/expertise':170 'run':461 'runcommand':438 'runtask':439 'runtest':440 'search':435 'searchresult':455 'secondari':239 'section':536,596,607,667,675,685,692,699,769 'select':250,268,271,557 'senior':181,199 'sentenc':144 'shot':409 'skill' 'skill-prompt-builder' 'source-github' 'special':30,446,482 'specialist':183 'specif':56,175,193,224,329,413,464,473,540,655,662,672,725,731 'standard':317,331,570 'start':590,785 'step':320,322,497,515,588,677,679,704 'step-by-step':319,676 'structur':16,374,416,532,574,630,697,724,765 'success':492,580,700 'systemat':82,608 'target':100 'task':55,70,223,229,242,551,560,644,666,669 'technic':177,457 'tell':787 'templat':615 'terminallastcommand':441 'test':162,753 'testfailur':454 'thing':347 'titl':659 'token':763 'token-effici':762 'tool':17,57,188,419,423,553,556,646,648 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'type':645 'unambigu':543 'updat':584 'usag':448,687 'use':267,275,336,405 'user':5,246,269 'usual':475 'valid':488,496,576,703 'variabl':263,287,299,686 'variablenam':290,293 'vs':46 'vscodeapi':449 'want':798 'well':534 'well-organ':533 'workflow':730 'workspac':298 'workspacefold':300 'xunit':741 'year':189,204","prices":[{"id":"1cf36603-f4cd-4afc-915b-b21d1f141f4b","listingId":"7a918c80-4e74-4d57-9d3e-1aa46c391338","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"github","category":"awesome-copilot","install_from":"skills.sh"},"createdAt":"2026-04-18T20:25:35.362Z"}],"sources":[{"listingId":"7a918c80-4e74-4d57-9d3e-1aa46c391338","source":"github","sourceId":"github/awesome-copilot/prompt-builder","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/prompt-builder","isPrimary":false,"firstSeenAt":"2026-04-18T21:50:41.882Z","lastSeenAt":"2026-05-18T18:52:21.167Z"},{"listingId":"7a918c80-4e74-4d57-9d3e-1aa46c391338","source":"skills_sh","sourceId":"github/awesome-copilot/prompt-builder","sourceUrl":"https://skills.sh/github/awesome-copilot/prompt-builder","isPrimary":true,"firstSeenAt":"2026-04-18T20:25:35.362Z","lastSeenAt":"2026-05-07T22:40:17.457Z"}],"details":{"listingId":"7a918c80-4e74-4d57-9d3e-1aa46c391338","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"prompt-builder","github":{"repo":"github/awesome-copilot","stars":33270,"topics":["agent-skills","agents","ai","awesome","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"license":"mit","html_url":"https://github.com/github/awesome-copilot","pushed_at":"2026-05-18T01:26:59Z","description":"Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.","skill_md_sha":"4e35b3d5492cda3668e3133dd5ab7829c2d38c4d","skill_md_path":"skills/prompt-builder/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/prompt-builder"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"name":"prompt-builder","description":"Guide users through creating high-quality GitHub Copilot prompts with proper structure, tools, and best practices."},"skills_sh_url":"https://skills.sh/github/awesome-copilot/prompt-builder"},"updatedAt":"2026-05-18T18:52:21.167Z"}}