Gsd Spike

What it does

Example prompts

• “/gsd-spike”

Requirements

• Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion, WebSearch, WebFetch, mcp__context7__resolve-library-id, mcp__context7__query-docs

What it can do on your machine

Read from SKILL.md and the folder at commit ed0f3fd. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Write
  • Edit
  • Bash
  • Grep
  • Glob
  • AskUserQuestion
  • WebSearch
  • WebFetch
  • mcp__context7__resolve-library-id

  …and 1 more on the same allowed-tools line.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gsd Spike loads about 584 tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 229 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~26

When it runs · the whole SKILL.md, loaded when a task matches

~584

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion, WebSearch, WebFetch, mcp__context7__resolve-li

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from open-gsd/gsd-core at commit ed0f3fd, republished under its MIT licence (© open-gsd). 229 words, ~584 tokens.

name

gsd-spike

description

Spike an idea through experiential exploration, or propose what to spike next (frontier mode)

allowed-tools

Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion, WebSearch, WebFetch, mcp__context7__resolve-library-id, mcp__context7__query-docs

argument-hint

[idea to validate] [--quick] [--text] [--wrap-up] or [frontier]

<objective>
Spike an idea through experiential exploration — build focused experiments to feel the pieces
of a future app, validate feasibility, and produce verified knowledge for the real build.
Spikes live in `.planning/spikes/` and integrate with GSD commit patterns, state tracking,
and handoff workflows.

<context>
Idea: the `<arguments>` block

<process>
Parse the first token of the `<arguments>` block:
- If it is `--wrap-up`: strip the flag, execute the spike-wrap-up workflow
- Otherwise: pass all of the `<arguments>` block as the idea to the spike workflow end-to-end.

© open-gsd, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/gsd-spike of open-gsd/gsd-core.

Open the folder on GitHubat commit ed0f3fd

Used in 2 other repositories

We found 13 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in open-gsd/gsd-core, which our catalogue first saw on October 7, 2026.

• protoconf/protoconf.kilo/skills/gsd-spike.codex/skills/gsd-spike+10 more
• davepoon/buildwithclaudeplugins/gsd/skills/spike