{"id":"92db961b-7fa2-4722-99cf-aa47a5f8a2fe","shortId":"K9Cc34","kind":"skill","title":"create-technical-spike","tagline":"Create time-boxed technical spike documents for researching and resolving critical development decisions before implementation.","description":"# Create Technical Spike Document\n\nCreate time-boxed technical spike documents for researching critical questions that must be answered before development can proceed. Each spike focuses on a specific technical decision with clear deliverables and timelines.\n\n## Document Structure\n\nCreate individual files in `${input:FolderPath|docs/spikes}` directory. Name each file using the pattern: `[category]-[short-description]-spike.md` (e.g., `api-copilot-integration-spike.md`, `performance-realtime-audio-spike.md`).\n\n```md\n---\ntitle: \"${input:SpikeTitle}\"\ncategory: \"${input:Category|Technical}\"\nstatus: \"🔴 Not Started\"\npriority: \"${input:Priority|High}\"\ntimebox: \"${input:Timebox|1 week}\"\ncreated: [YYYY-MM-DD]\nupdated: [YYYY-MM-DD]\nowner: \"${input:Owner}\"\ntags: [\"technical-spike\", \"${input:Category|technical}\", \"research\"]\n---\n\n# ${input:SpikeTitle}\n\n## Summary\n\n**Spike Objective:** [Clear, specific question or decision that needs resolution]\n\n**Why This Matters:** [Impact on development/architecture decisions]\n\n**Timebox:** [How much time allocated to this spike]\n\n**Decision Deadline:** [When this must be resolved to avoid blocking development]\n\n## Research Question(s)\n\n**Primary Question:** [Main technical question that needs answering]\n\n**Secondary Questions:**\n\n- [Related question 1]\n- [Related question 2]\n- [Related question 3]\n\n## Investigation Plan\n\n### Research Tasks\n\n- [ ] [Specific research task 1]\n- [ ] [Specific research task 2]\n- [ ] [Specific research task 3]\n- [ ] [Create proof of concept/prototype]\n- [ ] [Document findings and recommendations]\n\n### Success Criteria\n\n**This spike is complete when:**\n\n- [ ] [Specific criteria 1]\n- [ ] [Specific criteria 2]\n- [ ] [Clear recommendation documented]\n- [ ] [Proof of concept completed (if applicable)]\n\n## Technical Context\n\n**Related Components:** [List system components affected by this decision]\n\n**Dependencies:** [What other spikes or decisions depend on resolving this]\n\n**Constraints:** [Known limitations or requirements that affect the solution]\n\n## Research Findings\n\n### Investigation Results\n\n[Document research findings, test results, and evidence gathered]\n\n### Prototype/Testing Notes\n\n[Results from any prototypes, spikes, or technical experiments]\n\n### External Resources\n\n- [Link to relevant documentation]\n- [Link to API references]\n- [Link to community discussions]\n- [Link to examples/tutorials]\n\n## Decision\n\n### Recommendation\n\n[Clear recommendation based on research findings]\n\n### Rationale\n\n[Why this approach was chosen over alternatives]\n\n### Implementation Notes\n\n[Key considerations for implementation]\n\n### Follow-up Actions\n\n- [ ] [Action item 1]\n- [ ] [Action item 2]\n- [ ] [Update architecture documents]\n- [ ] [Create implementation tasks]\n\n## Status History\n\n| Date   | Status         | Notes                      |\n| ------ | -------------- | -------------------------- |\n| [Date] | 🔴 Not Started | Spike created and scoped   |\n| [Date] | 🟡 In Progress | Research commenced         |\n| [Date] | 🟢 Complete    | [Resolution summary]       |\n\n---\n\n_Last updated: [Date] by [Name]_\n```\n\n## Categories for Technical Spikes\n\n### API Integration\n\n- Third-party API capabilities and limitations\n- Integration patterns and authentication\n- Rate limits and performance characteristics\n\n### Architecture & Design\n\n- System architecture decisions\n- Design pattern applicability\n- Component interaction models\n\n### Performance & Scalability\n\n- Performance requirements and constraints\n- Scalability bottlenecks and solutions\n- Resource utilization patterns\n\n### Platform & Infrastructure\n\n- Platform capabilities and limitations\n- Infrastructure requirements\n- Deployment and hosting considerations\n\n### Security & Compliance\n\n- Security requirements and implementations\n- Compliance constraints\n- Authentication and authorization approaches\n\n### User Experience\n\n- User interaction patterns\n- Accessibility requirements\n- Interface design decisions\n\n## File Naming Conventions\n\nUse descriptive, kebab-case names that indicate the category and specific unknown:\n\n**API/Integration Examples:**\n\n- `api-copilot-chat-integration-spike.md`\n- `api-azure-speech-realtime-spike.md`\n- `api-vscode-extension-capabilities-spike.md`\n\n**Performance Examples:**\n\n- `performance-audio-processing-latency-spike.md`\n- `performance-extension-host-limitations-spike.md`\n- `performance-webrtc-reliability-spike.md`\n\n**Architecture Examples:**\n\n- `architecture-voice-pipeline-design-spike.md`\n- `architecture-state-management-spike.md`\n- `architecture-error-handling-strategy-spike.md`\n\n## Best Practices for AI Agents\n\n1. **One Question Per Spike:** Each document focuses on a single technical decision or research question\n\n2. **Time-Boxed Research:** Define specific time limits and deliverables for each spike\n\n3. **Evidence-Based Decisions:** Require concrete evidence (tests, prototypes, documentation) before marking as complete\n\n4. **Clear Recommendations:** Document specific recommendations and rationale for implementation\n\n5. **Dependency Tracking:** Identify how spikes relate to each other and impact project decisions\n\n6. **Outcome-Focused:** Every spike must result in an actionable decision or recommendation\n\n## Research Strategy\n\n### Phase 1: Information Gathering\n\n1. **Search existing documentation** using search/fetch tools\n2. **Analyze codebase** for existing patterns and constraints\n3. **Research external resources** (APIs, libraries, examples)\n\n### Phase 2: Validation & Testing\n\n1. **Create focused prototypes** to test specific hypotheses\n2. **Run targeted experiments** to validate assumptions\n3. **Document test results** with supporting evidence\n\n### Phase 3: Decision & Documentation\n\n1. **Synthesize findings** into clear recommendations\n2. **Document implementation guidance** for development team\n3. **Create follow-up tasks** for implementation\n\n## Tools Usage\n\n- **search/searchResults:** Research existing solutions and documentation\n- **fetch/githubRepo:** Analyze external APIs, libraries, and examples\n- **codebase:** Understand existing system constraints and patterns\n- **runTasks:** Execute prototypes and validation tests\n- **editFiles:** Update research progress and findings\n- **vscodeAPI:** Test VS Code extension capabilities and limitations\n\nFocus on time-boxed research that resolves critical technical decisions and unblocks development progress.","tags":["create","technical","spike","awesome","copilot","github","agent-skills","agents","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"capabilities":["skill","source-github","skill-create-technical-spike","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/create-technical-spike","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,388 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:08.774Z","embedding":null,"createdAt":"2026-04-18T20:25:58.890Z","updatedAt":"2026-05-18T18:52:08.774Z","lastSeenAt":"2026-05-18T18:52:08.774Z","tsv":"'1':99,176,190,216,326,478,564,567,593,619 '2':179,194,219,329,494,574,590,601,625 '3':182,198,508,582,608,616,632 '4':523 '5':533 '6':547 'access':437 'action':323,324,327,557 'affect':236,256 'agent':477 'ai':476 'alloc':146 'altern':313 'analyz':575,649 'answer':39,171 'api':289,366,371,586,651 'api-azure-speech-realtime-spike.md':461 'api-copilot-chat-integration-spike.md':460 'api-copilot-integration-spike.md':79 'api-vscode-extension-capabilities-spike.md':462 'api/integration':458 'applic':228,391 'approach':309,431 'architectur':331,384,387,468 'architecture-error-handling-strategy-spike.md':472 'architecture-state-management-spike.md':471 'architecture-voice-pipeline-design-spike.md':470 'assumpt':607 'authent':378,428 'author':430 'avoid':158 'base':302,511 'best':473 'block':159 'bottleneck':402 'box':8,28,497,686 'capabl':372,411,679 'case':449 'categori':73,85,87,119,362,454 'characterist':383 'chosen':311 'clear':53,127,220,300,524,623 'code':677 'codebas':576,655 'commenc':352 'communiti':293 'complet':212,226,354,522 'complianc':421,426 'compon':232,235,392 'concept':225 'concept/prototype':202 'concret':514 'consider':317,419 'constraint':250,400,427,581,659 'context':230 'convent':444 'creat':2,5,21,25,59,101,199,333,345,594,633 'create-technical-spik':1 'criteria':208,215,218 'critic':16,34,690 'date':338,341,348,353,359 'dd':105,110 'deadlin':151 'decis':18,51,131,141,150,239,245,298,388,441,490,512,546,558,617,692 'defin':499 'deliver':54,504 'depend':240,246,534 'deploy':416 'descript':76,446 'design':385,389,440 'develop':17,41,160,630,695 'development/architecture':140 'directori':66 'discuss':294 'docs/spikes':65 'document':11,24,31,57,203,222,263,286,332,484,518,526,570,609,618,626,647 'e.g':78 'editfil':668 'everi':551 'evid':269,510,515,614 'evidence-bas':509 'exampl':459,464,469,588,654 'examples/tutorials':297 'execut':663 'exist':569,578,644,657 'experi':280,433,604 'extens':678 'extern':281,584,650 'fetch/githubrepo':648 'file':61,69,442 'find':204,260,265,305,621,673 'focus':46,485,550,595,682 'folderpath':64 'follow':321,635 'follow-up':320,634 'gather':270,566 'guidanc':628 'high':95 'histori':337 'host':418 'hypothes':600 'identifi':536 'impact':138,544 'implement':20,314,319,334,425,532,627,639 'indic':452 'individu':60 'inform':565 'infrastructur':409,414 'input':63,83,86,93,97,112,118,122 'integr':367,375 'interact':393,435 'interfac':439 'investig':183,261 'item':325,328 'kebab':448 'kebab-cas':447 'key':316 'known':251 'last':357 'librari':587,652 'limit':252,374,380,413,502,681 'link':283,287,291,295 'list':233 'main':166 'mark':520 'matter':137 'md':81 'mm':104,109 'model':394 'much':144 'must':37,154,553 'name':67,361,443,450 'need':133,170 'note':272,315,340 'object':126 'one':479 'outcom':549 'outcome-focus':548 'owner':111,113 'parti':370 'pattern':72,376,390,407,436,579,661 'per':481 'perform':382,395,397,463 'performance-audio-processing-latency-spike.md':465 'performance-extension-host-limitations-spike.md':466 'performance-realtime-audio-spike.md':80 'performance-webrtc-reliability-spike.md':467 'phase':563,589,615 'plan':184 'platform':408,410 'practic':474 'primari':164 'prioriti':92,94 'proceed':43 'progress':350,671,696 'project':545 'proof':200,223 'prototyp':276,517,596,664 'prototype/testing':271 'question':35,129,162,165,168,173,175,178,181,480,493 'rate':379 'rational':306,530 'recommend':206,221,299,301,525,528,560,624 'refer':290 'relat':174,177,180,231,539 'relev':285 'requir':254,398,415,423,438,513 'research':13,33,121,161,185,188,192,196,259,264,304,351,492,498,561,583,643,670,687 'resolut':134,355 'resolv':15,156,248,689 'resourc':282,405,585 'result':262,267,273,554,611 'run':602 'runtask':662 'scalabl':396,401 'scope':347 'search':568 'search/fetch':572 'search/searchresults':642 'secondari':172 'secur':420,422 'short':75 'short-descript':74 'singl':488 'skill' 'skill-create-technical-spike' 'solut':258,404,645 'source-github' 'specif':49,128,187,191,195,214,217,456,500,527,599 'spike':4,10,23,30,45,117,125,149,210,243,277,344,365,482,507,538,552 'spike.md':77 'spiketitl':84,123 'start':91,343 'status':89,336,339 'strategi':562 'structur':58 'success':207 'summari':124,356 'support':613 'synthes':620 'system':234,386,658 'tag':114 'target':603 'task':186,189,193,197,335,637 'team':631 'technic':3,9,22,29,50,88,116,120,167,229,279,364,489,691 'technical-spik':115 'test':266,516,592,598,610,667,675 'third':369 'third-parti':368 'time':7,27,145,496,501,685 'time-box':6,26,495,684 'timebox':96,98,142 'timelin':56 'titl':82 'tool':573,640 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'track':535 'unblock':694 'understand':656 'unknown':457 'updat':106,330,358,669 'usag':641 'use':70,445,571 'user':432,434 'util':406 'valid':591,606,666 'vs':676 'vscodeapi':674 'week':100 'yyyi':103,108 'yyyy-mm-dd':102,107","prices":[{"id":"d4437156-4408-47a9-82e8-65eb2c3b28c1","listingId":"92db961b-7fa2-4722-99cf-aa47a5f8a2fe","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:58.890Z"}],"sources":[{"listingId":"92db961b-7fa2-4722-99cf-aa47a5f8a2fe","source":"github","sourceId":"github/awesome-copilot/create-technical-spike","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/create-technical-spike","isPrimary":false,"firstSeenAt":"2026-04-18T21:48:55.386Z","lastSeenAt":"2026-05-18T18:52:08.774Z"},{"listingId":"92db961b-7fa2-4722-99cf-aa47a5f8a2fe","source":"skills_sh","sourceId":"github/awesome-copilot/create-technical-spike","sourceUrl":"https://skills.sh/github/awesome-copilot/create-technical-spike","isPrimary":true,"firstSeenAt":"2026-04-18T20:25:58.890Z","lastSeenAt":"2026-05-07T22:40:18.456Z"}],"details":{"listingId":"92db961b-7fa2-4722-99cf-aa47a5f8a2fe","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"create-technical-spike","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":"bac8a01d6251010f639fbab6a15038a43afca047","skill_md_path":"skills/create-technical-spike/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/create-technical-spike"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"name":"create-technical-spike","description":"Create time-boxed technical spike documents for researching and resolving critical development decisions before implementation."},"skills_sh_url":"https://skills.sh/github/awesome-copilot/create-technical-spike"},"updatedAt":"2026-05-18T18:52:08.774Z"}}