Decide the open unknowns of a spex spec — library choices, versions, how an existing API behaves — and write research.md plus a one-line decision per unknown into requirements.yaml. Use when the user says "research", "spex research", "resolve the unknowns", or when spex gate plan reports GATE-UNKNOWN. It changes no requirement.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# spex research
`SPEX` = `node ${CLAUDE_PLUGIN_ROOT}/scripts/spex.mjs`, from the repo root.
## Steps
1. Read `unknowns[]` in `<dir>/requirements.yaml`. Work only on the entries without a
`decision`. If there are none, say so and stop.
2. Say it first, in one line: `Research: 3 unknowns → 3 agents`. Then start one
`spex:researcher` subagent per unknown, all in one message so they run at the same time.
Give each the `ask`, what it decides, and where to look: the dependency manifest, the
module the unknown names, a contract, the library's documentation. Each returns the
answer, the sources it opened, and a confidence. Do not read the whole codebase yourself.
3. Write `<dir>/research.md`, one section per unknown, heading `## U1 — <ask>`:
the options considered, the decision, why, and the sources (file paths, URLs, versions).
This file is for people; no later run reads it whole.
4. Write the decision back into `requirements.yaml`, one line that carries its reason:
`decision: csv-stringify 6.x, because the repo already depends on it.` and
`ref: research.md#u1`. That one line is what `tasks` and `develop` will see.
…
The line at the top of this page pins the label git:20261107.629412d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_bilkpdbpxxdm4too
GET https://markdownregistry.com/api/v1/resolve?ref=lukaskellerstein/claude-my-marketplace/research
GET https://markdownregistry.com/api/v1/blob/6e4889faa72d9f62825afcfd8d57e24de26cd5365642a48fc5b9118589a42ce1
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
lukaskellerstein/claude-my-marketplace · _archive/paperclip-plugin/skills/infrastructure-planning/SKILL.md · Plan and document the required software, infrastructure, and logistics for a Paperclip company — domains, GitHub…
lukaskellerstein/claude-my-marketplace · _archive/paperclip-plugin/skills/work-planning/SKILL.md · Design the complete work hierarchy for a Paperclip company — Goals, Projects, and Tasks as a unified top-down planning…
lukaskellerstein/claude-my-marketplace · plugins/demo-video-plugin/skills/demo-app-prep/SKILL.md · Gets a project into a demo-worthy, deterministic state before recording — boots the app, seeds realistic data, bypasses…
lukaskellerstein/claude-my-marketplace · plugins/demo-video-plugin/skills/demo-assembly/SKILL.md · Assembles measured clips and narration into a finished demo video — reconciles real durations into a timeline, then…
lukaskellerstein/claude-my-marketplace · plugins/demo-video-plugin/skills/demo-capture/SKILL.md · Records demo video clips by driving a running app — one clip per storyboard section, with human-feeling pointer motion…
lukaskellerstein/claude-my-marketplace · plugins/demo-video-plugin/skills/demo-graphics/SKILL.md · Dresses the Final Cut Pro finish of a demo video with Motion templates — MotionVFX DesignStudio elements downloaded…
lukaskellerstein/claude-my-marketplace · plugins/demo-video-plugin/skills/demo-review/SKILL.md · Quality-checks a rendered demo video before it ships — extracts frames, grades each section against its…
lukaskellerstein/claude-my-marketplace · plugins/demo-video-plugin/skills/demo-scripting/SKILL.md · Turns a codebase into a demo narrative that has value — picks which capabilities earn screen time, structures them into…
lukaskellerstein/claude-my-marketplace · plugins/demo-video-plugin/skills/demo-video/SKILL.md · Orchestrates building a narrated demo video of a project — reads the codebase, writes a storyboard, prepares…
lukaskellerstein/claude-my-marketplace · plugins/demo-video-plugin/skills/demo-voiceover/SKILL.md · Generates demo narration with the ElevenLabs MCP server — one audio file per storyboard section, measured so the editor…
sethgammon/citadel · skills/research/SKILL.md · Focused research investigations. Converts questions into structured findings with confidence levels and source…
zhongkaifu/tensorsharp · TensorAgent/skills/research/SKILL.md · Use for web searches and current information lookups, finding sources, and fact-checking without being given any URLs…
oliver-kriska/claude-elixir-phoenix · plugins/elixir-phoenix/skills/research/SKILL.md · Research Elixir/Phoenix/Ecto topics or evaluate Hex libraries (--library). Use when learning about libraries, patterns…
aiskillstore/marketplace · pending/warpdotdev/research/SKILL.md · Delegate noisy investigation to one or more subagents so the orchestrator's context stays clean, then work from the…
boshu2/agentops · skills/research/SKILL.md · Answer one cited question on code, history, claims or patterns. Use when: asked how it works, why it changed, if a…
