ai4s-research/research-explorer
Use when the user has a vague research direction and wants to explore feasible specific topics. Outputs a structured analysis with candidate topics, innovation/feasibility scoring, and a pre-survey of 20–30 representative works. Single-stage, no Python runtime.
npx skills add https://github.com/ai4s-research/ai4s-skills --skill research-explorer
Research-topic exploration SKILL. Takes a broad direction, performs multi-dimensional web research with the agent's own WebSearch / WebFetch tools, and produces three structured Markdown deliverables. Single stage, full quality from the start. No Python runtime, no LLM SDK.
literature-survey or paper-writer.Confirm with the user:
DIRECTION="<direction>"
SLUG=$(python3 -c "import re,hashlib,sys; t=sys.argv[1]; n=re.sub(r'[\\s_]+','-',re.sub(r'[^\\w\\s-]','',t.lower().strip())).strip('-')[:40].rstrip('-'); h=hashlib.sha1(t.encode()).hexdigest()[:8]; print(f'{n}-{h}')" "$DIRECTION")
TS=$(date +%Y-%m-%d_%H%M%S)
RUN=output/research-explorer/$SLUG/$TS
mkdir -p "$RUN"
ln -sfn "$TS" "output/research-explorer/$SLUG/latest"
In commands below $RUN = output/research-explorer/<slug>/latest.
Run WebSearch across the following dimensions (one query per dimension, more if returns are thin):
For each kept candidate, WebFetch the abstract URL to extract canonical title / authors / year / venue. Persist intermediate notes to $RUN/search_notes.md after every dimension so the work resumes cleanly.
Write these in $RUN/:
research_exploration.mdStructured analysis containing:
topic_matrix.mdA hierarchical Markdown outline of the topic space:
# <Direction>
## Subfield A
### Topic A.1
### Topic A.2
## Subfield B
### Topic B.1
This file is consumable by the mindmap-render skill to produce a visual mindmap.
literature_pre_survey.mdA pre-survey table of 20–30 representative works discovered above, with columns: title, authors, year, venue, URL, one-sentence relevance note. Every entry must have a URL the agent fetched in this session.
If the user picks a topic, suggest the next skill:
paper-writer skill (using the chosen topic).literature-survey skill.experiment-suite skill.mindmap-render skill consuming topic_matrix.md.A downstream skill can locate this exploration via the slug:
output/research-explorer/<slug>/latest/topic_matrix.mdoutput/research-explorer/<slug>/latest/literature_pre_survey.mdIf the user picks one topic from the matrix, downstream skills compute their own slug from the topic (not the original direction), so the slug paths diverge from this skill onward — which is correct.
SKILL.md.Take ai4s-research/research-explorer from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.