spike

Build throwaway prototypes to validate technical feasibility before committing to a real build.

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/swcstudiospace/aimeecodes --skill spike-swcstudiospace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spike
Source: https://github.com/swcstudiospace/aimeecodes/tree/main/.aimee/skills/spike
Command: npx skills add https://github.com/swcstudiospace/aimeecodes --skill spike-swcstudiospace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before committing to a real build, teams often need to know whether an idea is technically feasible, which approach is better, or what unknowns could kill the project. This Skill structures that exploration into disposable, evidence-backed experiments instead of guesswork. ## Core Features & Use Cases - Decompose ideas into spikes: Breaks a vague idea into 2-5 independent feasibility questions framed as Given/When/Then statements, ordered by risk. - Research then build: Surfaces competing libraries and approaches, picks one, then builds a minimal runnable prototype (CLI, HTML page, or single-endpoint server) in a standalone spikes/NNN-name/ directory. - Comparison spikes: Builds competing approaches side by side (e.g., pdfjs vs camelot) and produces a head-to-head verdict table. - Verdict reporting: Each spike closes with a VALIDATED, PARTIAL, or INVALIDATED verdict plus recommendations for the real build. - Use Case: You want to know if streaming LLM tokens over websockets can stay under 100ms latency. The Skill creates spikes/001-websocket-streaming/, builds a runnable prototype, tests edge cases, and records a verdict with evidence. ## Quick Start Ask the agent to spike whether your idea is feasible, for example: "Spike whether we can parse multi-page PDFs into structured text, comparing pdfjs and camelot."

Frequently Asked Questions about spike

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

FAQPage Schema
How do I validate a technical idea before building it?▼

Run a spike: decompose the idea into 2-5 feasibility questions framed as Given/When/Then, order them by risk, then build a minimal runnable prototype for each. Close each spike with a VALIDATED, PARTIAL, or INVALIDATED verdict backed by observed evidence.

How do I compare two libraries or approaches for the same task?▼

Build comparison spikes with a shared number and letter suffixes (e.g., 002a and 002b), one per approach, then write a head-to-head table covering dimensions like output quality, setup complexity, and performance. Declare a winner for your specific use case.

When should I not use a spike?▼

Skip spiking when the answer is knowable from documentation or reading code, when the work is on the production path (use a planning workflow instead), or when the idea is already validated and you can jump straight to implementation.

What makes a good spike question?▼

A good spike question targets specific feasibility with observable output, such as whether websocket streaming delivers chunks under 100ms. Bad questions are too broad, have no observable output, or merely ask to read documentation about a topic.

What should the output of a spike look like?▼

Each spike lives in its own directory like spikes/001-websocket-streaming/ with a README.md capturing the question, approach, results, and verdict. Prefer interactive outputs such as a runnable CLI or minimal HTML page over a bare log line.