internal/embed/claude/skills/bootstrap/SKILL.md
Mandatory activation layer — loads on any conversation start. Establishes skill-loading protocol, Red Flags, priority rules, and HARD-GATE enforcement for all research-loop skills.
npx skillsauth add moralespanitz/research-loop bootstrapInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
If you think there is even a 1% chance a skill from the routing table might apply to what you are doing, you ABSOLUTELY MUST invoke the skill.
IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.
This is not negotiable. This is not optional. You cannot rationalize your way out of this. </EXTREMELY-IMPORTANT>
The full skill routing table — with exact trigger phrases for every research-loop skill — is in CLAUDE.md. Read it. The summary below is a quick reference; always check CLAUDE.md for the authoritative list.
| Skill | Trigger summary |
|-------|-----------------|
| research-loop | Entry point — user mentions research, a topic, papers, experiments, gaps, or hypotheses |
| deep-research | User needs a thorough, source-heavy investigation with subagent dispatch and provenance tracking |
| literature-review | User wants a structured review of the literature with evidence tables and quality scoring |
| replication | User wants to reproduce published results from a paper, claim, or benchmark |
| status | User asks about progress, pending items, what to do next |
| learn | User asks for explanations, definitions, or "teach me" |
| explore | User wants to find papers, map a field, or survey the landscape |
| idea-selection | User wants to find gaps, what hasn't been tried, or worth pursuing |
| discover | User wants to test multiple angles or run parallel hypothesis lanes |
| plan | User asks for next steps, how to start, or concrete tasks |
| loop | User has a hypothesis and wants to run experiments |
| autonomous-iteration | User has a measurable metric and wants automated optimization; or invokes $research-loop variants |
| execution | User shares results and wants to decide: continue, pivot, or kill |
| paper-pipeline | User wants a full end-to-end paper pipeline — topic to export |
| experiment-sandbox | User needs to run experiments in a sandboxed environment |
| figure-agent | User needs publication-quality figures for a paper |
| bootstrap | Conversation start — loads automatically to activate the skill-loading protocol |
| getting-started | First session in a new workspace — load this FIRST |
| review-prep | User is preparing for submission or handling a rejection |
| writing-papers | User is ready to write a paper |
| autoresearch | User wants to run autonomous nanochat/GPT training experiments using karpathy/autoresearch |
If your researcher partner says "don't use X" and a skill says "always use X," follow your researcher partner. They are in control.
Invoke skills BEFORE any response or action. Even a 1% chance a skill might apply means you must invoke the skill to check. If an invoked skill turns out to be wrong for the situation, you don't need to use it.
Flow:
These thoughts mean you are finding excuses not to load a skill. Catch yourself:
| Thought | Reality |
|---------|---------|
| "This is just a simple question" | Questions are research tasks. Check for skills. |
| "I need more context first" | Skill check comes BEFORE clarifying questions. |
| "Let me search the literature first" | Skills tell you HOW to search. Check first. |
| "I remember the topic, I can answer from memory" | Never answer research from memory. Load the skill. |
| "I can just check the files really fast" | Files lack conversation context. Check for skills. |
| "This doesn't need a formal skill" | If a skill exists, use it. Period. |
| "The skill is overkill for this" | Simple questions reveal deep gaps. Use learn. |
| "I'll just do this one thing first before checking" | Check skills BEFORE doing anything. |
| "I know what that means" | Knowing the concept ≠ using the skill. Invoke it. |
| "Let me gather information first" | Skills tell you HOW to gather information. |
| "I'll skip the conversational gate, the path is obvious" | Bad ideas feel obvious. The gate exists because of this. |
| "I can handle this without the skill" | If a skill exists, use it. Confidence is not a substitute. |
| "This feels productive" | Undisciplined action wastes time. Skills prevent this. |
When several skills could match, load them in this order:
research-loop (advisor mode / entry point)deep-research (thorough investigation with subagents)literature-review (structured review of literature)replication (reproduce published results)bootstrap (conversation start — skill-loading protocol)status (where are we in the pipeline)learn (understand concepts)getting-started (first session in new workspace)review-prep (submission / rejection handling)writing-papers (drafting standalone papers)paper-pipeline (end-to-end topic to export)experiment-sandbox (sandboxed experiment execution)figure-agent (publication-quality figures)autoresearch (autonomous nanochat/GPT training experiments)explore (find papers, map field)idea-selection (find gaps, surface opportunities)discover (parallel hypothesis lanes)plan (concrete tasks, milestones)loop (experiment design and execution)execution (results analysis: continue, pivot, kill)Examples:
research-loop first, then discovery, then execution.status first.status for pipeline location, then the appropriate stage skill.loop (rigid — follow exactly).If you have not loaded a skill before answering, you have not done your job.
Violation procedure:
Rigid (loop, execution, status): Follow exactly. Don't adapt away discipline.
Flexible (research-loop, discover, idea-selection): Adapt principles to the research context.
The skill itself tells you which type it is.
Statements like "explore this topic" or "find gaps in X" are goals, not instructions to skip the workflow. Always load the matching skill to determine HOW to accomplish what is being asked.
testing
Plan and execute a structured replication workflow for a paper, claim, or benchmark with environment selection and integrity checks.
testing
End-to-end paper generation pipeline ported from AutoResearchClaw (Aiming Lab). 14 phases covering topic initiation through export/publish, with human- in-the-loop gates and quality gating at each handoff. Use this when the user wants a full paper pipeline run — topic to submission-ready manuscript. Delegates to researcher/reviewer/writer/verifier subagents for stage execution and to autonomous-iteration for experiment optimization loops.
testing
Run a structured literature review on a topic using parallel search, evidence tables with quality scoring, and primary-source synthesis.
development
Publication-quality figure generation for research papers. Decision agent selects figure type (code plot vs architecture diagram). Generates Matplotlib/Seaborn code for quantitative figures with iterative improvement loop. Style-matches conference templates (NeurIPS, ICML, ICLR). Use when the paper-pipeline reaches the figure generation phase, or when a user requests figures for an existing draft.