create-technical-spike

Create time-boxed technical spike documents for researching critical development decisions.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/miyake-san/sogo-agent-platform --skill create-technical-spike-miyake-san
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-technical-spike
Source: https://github.com/miyake-san/sogo-agent-platform/tree/main/skills/core/create-technical-spike
Command: npx skills add https://github.com/miyake-san/sogo-agent-platform --skill create-technical-spike-miyake-san

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Development teams often face unresolved technical questions that block implementation, and without a structured research process these decisions get made ad hoc or delayed indefinitely. This Skill produces standardized, time-boxed spike documents that capture research questions, investigation plans, findings, and actionable recommendations. ## Core Features & Use Cases - Structured Spike Template: Generates a complete Markdown spike document with sections for research questions, investigation plans, success criteria, findings, decisions, and status history. - Category-Based Organization: Supports spike categories including API integration, architecture, performance, platform, security, and user experience, with kebab-case file naming conventions. - Phased Research Strategy: Guides a three-phase workflow of information gathering, prototype validation, and decision documentation. - Use Case: Before integrating a third-party speech API, create an api-azure-speech-realtime-spike.md document that time-boxes the investigation to one week, defines success criteria, and ends with a clear recommendation for the team. ## Quick Start Create a technical spike document in docs/spikes for evaluating whether the Copilot chat API supports our real-time integration requirements, time-boxed to one week.

Frequently Asked Questions about create-technical-spike

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a technical spike document?

Define one primary research question, set a timebox and decision deadline, list investigation tasks with success criteria, then document findings and a clear recommendation. This Skill generates the full Markdown template with all required sections.

What is a technical spike in agile development?

A technical spike is a time-boxed research activity used to answer a specific technical question before development proceeds. It ends with an evidence-based recommendation, often supported by a prototype or proof of concept.

How should technical spike files be named and organized?

Use kebab-case names following the pattern [category]-[short-description]-spike.md, such as api-copilot-integration-spike.md, and store them in a dedicated folder like docs/spikes for discoverability.

When should I use a spike instead of starting implementation?

Use a spike when a technical decision is unresolved and blocks development, such as unknown API capabilities, performance constraints, or architecture choices. If the answer is already known or low-risk, implement directly instead.

What categories of technical spikes are supported?

The Skill covers API integration, architecture and design, performance and scalability, platform and infrastructure, security and compliance, and user experience spikes, each with example naming patterns.