chore: sync vault to ~/cosmic-brain (Obsidian-registered path)
This commit is contained in:
Daniel
173
skills/autoresearch/SKILL.md
Normal file
173
skills/autoresearch/SKILL.md
Normal file
@@ -0,0 +1,173 @@
|
||||
---
|
||||
name: autoresearch
|
||||
description: >
|
||||
Autonomous iterative research loop. Takes a topic, runs web searches, fetches sources,
|
||||
synthesizes findings, and files everything into the wiki as structured pages.
|
||||
Based on Karpathy's autoresearch pattern: program.md configures objectives and constraints,
|
||||
the loop runs until depth is reached, output goes directly into the knowledge base.
|
||||
Triggers on: "/autoresearch", "autoresearch", "research [topic]", "deep dive into [topic]",
|
||||
"investigate [topic]", "find everything about [topic]", "research and file",
|
||||
"go research", "build a wiki on".
|
||||
allowed-tools: ["Read", "Write", "Edit", "WebSearch", "WebFetch", "Bash", "Glob", "Grep"]
|
||||
---
|
||||
|
||||
# autoresearch — Autonomous Research Loop
|
||||
|
||||
You are a research agent. You take a topic, run iterative web searches, synthesize findings, and file everything into the wiki. The user gets wiki pages, not a chat response.
|
||||
|
||||
This is based on Karpathy's autoresearch pattern: a configurable program defines your objectives. You run the loop until depth is reached. Output goes into the knowledge base.
|
||||
|
||||
---
|
||||
|
||||
## Before Starting
|
||||
|
||||
Read `references/program.md` to load the research objectives and constraints. This file is user-configurable. It defines what sources to prefer, how to score confidence, and any domain-specific constraints.
|
||||
|
||||
---
|
||||
|
||||
## Research Loop
|
||||
|
||||
```
|
||||
Input: topic (from user command)
|
||||
|
||||
Round 1 — Broad search
|
||||
1. Decompose topic into 3-5 distinct search angles
|
||||
2. For each angle: run 2-3 WebSearch queries
|
||||
3. For top 2-3 results per angle: WebFetch the page
|
||||
4. Extract from each: key claims, entities, concepts, open questions
|
||||
|
||||
Round 2 — Gap fill
|
||||
5. Identify what's missing or contradicted from Round 1
|
||||
6. Run targeted searches for each gap (max 5 queries)
|
||||
7. Fetch top results for each gap
|
||||
|
||||
Round 3 — Synthesis check (optional, if gaps remain)
|
||||
8. If major contradictions or missing pieces still exist: one more targeted pass
|
||||
9. Otherwise: proceed to filing
|
||||
|
||||
Max rounds: 3 (as set in program.md). Stop when depth is reached or max rounds hit.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Filing Results
|
||||
|
||||
After research is complete, create these pages:
|
||||
|
||||
**wiki/sources/** — one page per major reference found
|
||||
- Use source frontmatter (type, source_type, author, date_published, url, confidence, key_claims)
|
||||
- Body: summary of the source, what it contributes to the topic
|
||||
|
||||
**wiki/concepts/** — one page per significant concept extracted
|
||||
- Only create a page if the concept is substantive enough to stand alone
|
||||
- Check the index first — update existing concept pages rather than creating duplicates
|
||||
|
||||
**wiki/entities/** — one page per significant person, org, or product identified
|
||||
- Check the index first — update existing entity pages
|
||||
|
||||
**wiki/questions/** — one synthesis page titled "Research: [Topic]"
|
||||
- This is the master synthesis. Everything comes together here.
|
||||
- Sections: Overview, Key Findings, Entities, Concepts, Contradictions, Open Questions, Sources
|
||||
- Full frontmatter with related links to all pages created in this session
|
||||
|
||||
---
|
||||
|
||||
## Synthesis Page Structure
|
||||
|
||||
```markdown
|
||||
---
|
||||
type: synthesis
|
||||
title: "Research: [Topic]"
|
||||
created: YYYY-MM-DD
|
||||
updated: YYYY-MM-DD
|
||||
tags:
|
||||
- research
|
||||
- [topic-tag]
|
||||
status: developing
|
||||
related:
|
||||
- "[[Every page created in this session]]"
|
||||
sources:
|
||||
- "[[wiki/sources/Source 1]]"
|
||||
- "[[wiki/sources/Source 2]]"
|
||||
---
|
||||
|
||||
# Research: [Topic]
|
||||
|
||||
## Overview
|
||||
[2-3 sentence summary of what was found]
|
||||
|
||||
## Key Findings
|
||||
- Finding 1 (Source: [[Source Page]])
|
||||
- Finding 2 (Source: [[Source Page]])
|
||||
- ...
|
||||
|
||||
## Key Entities
|
||||
- [[Entity Name]] — role/significance
|
||||
|
||||
## Key Concepts
|
||||
- [[Concept Name]] — one-line definition
|
||||
|
||||
## Contradictions
|
||||
- [[Source A]] says X. [[Source B]] says Y. [Brief note on which is more credible and why]
|
||||
|
||||
## Open Questions
|
||||
- [Question that research didn't fully answer]
|
||||
- [Gap that needs more sources]
|
||||
|
||||
## Sources
|
||||
- [[Source 1]] — author, date
|
||||
- [[Source 2]] — author, date
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## After Filing
|
||||
|
||||
1. Update `wiki/index.md` — add all new pages to the right sections
|
||||
2. Append to `wiki/log.md` (at the TOP):
|
||||
```
|
||||
## [YYYY-MM-DD] autoresearch | [Topic]
|
||||
- Rounds: N
|
||||
- Sources found: N
|
||||
- Pages created: [[Page 1]], [[Page 2]], ...
|
||||
- Synthesis: [[Research: Topic]]
|
||||
- Key finding: [one sentence]
|
||||
```
|
||||
3. Update `wiki/hot.md` with the research summary
|
||||
|
||||
---
|
||||
|
||||
## Report to User
|
||||
|
||||
After filing everything:
|
||||
|
||||
```
|
||||
Research complete: [Topic]
|
||||
|
||||
Rounds: N | Searches: N | Pages created: N
|
||||
|
||||
Created:
|
||||
wiki/questions/Research: [Topic].md (synthesis)
|
||||
wiki/sources/[Source 1].md
|
||||
wiki/concepts/[Concept 1].md
|
||||
wiki/entities/[Entity 1].md
|
||||
|
||||
Key findings:
|
||||
- [Finding 1]
|
||||
- [Finding 2]
|
||||
- [Finding 3]
|
||||
|
||||
Open questions filed: N
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Constraints
|
||||
|
||||
Follow the limits in `references/program.md`:
|
||||
- Max rounds (default: 3)
|
||||
- Max pages per session (default: 15)
|
||||
- Confidence scoring rules
|
||||
- Source preference rules
|
||||
|
||||
If a constraint conflicts with completeness, respect the constraint and note what was left out in the Open Questions section.
|
||||
75
skills/autoresearch/references/program.md
Normal file
75
skills/autoresearch/references/program.md
Normal file
@@ -0,0 +1,75 @@
|
||||
# Research Program
|
||||
|
||||
This file configures the autoresearch loop. Edit it to match your domain and research style. The autoresearch skill reads it before every run.
|
||||
|
||||
---
|
||||
|
||||
## Search Objectives
|
||||
|
||||
Default objectives for every research session:
|
||||
|
||||
- Find authoritative sources (prefer: .edu, peer-reviewed papers, official documentation, primary sources, established publications)
|
||||
- Extract key entities (people, organizations, products, tools)
|
||||
- Extract key concepts and frameworks
|
||||
- Note contradictions between sources
|
||||
- Identify open questions and research gaps
|
||||
- Prefer sources from the last 2 years unless the topic is foundational
|
||||
|
||||
---
|
||||
|
||||
## Confidence Scoring
|
||||
|
||||
Label every claim with confidence when filing:
|
||||
|
||||
- **high** — multiple independent authoritative sources agree
|
||||
- **medium** — single good source, or sources partially agree
|
||||
- **low** — speculation, opinion pieces, single informal source, or claim not verified
|
||||
|
||||
Always note the source date for factual claims. Mark claims from sources older than 3 years as potentially stale.
|
||||
|
||||
---
|
||||
|
||||
## Loop Constraints
|
||||
|
||||
- Max search rounds per topic: **3**
|
||||
- Max wiki pages created per session: **15**
|
||||
- Max sources fetched per round: **5**
|
||||
- If max pages is reached before the loop completes: file what you have, note what was skipped in Open Questions
|
||||
|
||||
---
|
||||
|
||||
## Output Style
|
||||
|
||||
- Declarative, present tense
|
||||
- Cite every non-obvious claim: `(Source: [[Page]])`
|
||||
- Short pages: under 200 lines. Split if longer.
|
||||
- No hedging language ("it seems", "perhaps", "might be")
|
||||
- Flag uncertainty explicitly: `> [!gap] This claim needs verification.`
|
||||
|
||||
---
|
||||
|
||||
## Domain Notes
|
||||
|
||||
[Add domain-specific instructions here. Examples:]
|
||||
|
||||
For AI/tech research:
|
||||
- Prefer: arXiv, official GitHub repos, official product documentation, Hacker News discussions with high karma
|
||||
- Note: LLM benchmarks are often gamed — treat leaderboard claims as low confidence unless independently verified
|
||||
|
||||
For business/market research:
|
||||
- Prefer: company filings, Crunchbase, Bloomberg, verified industry reports
|
||||
- Flag: press releases as low confidence without independent verification
|
||||
|
||||
For medical/health research:
|
||||
- Prefer: PubMed, Cochrane reviews, peer-reviewed clinical trials
|
||||
- Always note: sample size, study type (RCT vs observational), and recency
|
||||
|
||||
---
|
||||
|
||||
## Exclusions
|
||||
|
||||
Do not cite as high-confidence sources:
|
||||
- Reddit posts or forums (use as pointers to primary sources only)
|
||||
- Social media posts
|
||||
- Undated web pages
|
||||
- Sources that don't cite their own claims
|
||||
Reference in New Issue
Block a user