Research Note
eruto-skills/research-note
Pesquisa multifontes com notas footnoted e avaliação de qualidade
Ver no GitHubSkill do Claude Code que pesquisa qualquer tópico e gera notas Markdown footnoted com avaliação de qualidade das fontes e mindmaps Mermaid opcionais. Integra múltiplas fontes (web, YouTube, PDFs, Twitter, GitHub) com sistemática de confiabilidade das fontes.
Instalação
npx convez-ai eruto-skills/research-note1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Pesquisa acadêmica com fontes verificadas
- Documentação de aprendizado com mindmaps conceituais
- Análise comparativa de tópicos com visualizações
- Extração e sintetização de conteúdo de vídeos e artigos
Veredito

Ferramenta sólida para pesquisa estruturada com rigor editorial, ideal para quem precisa de notas com rastreamento de fontes. Requer setup de dependências (yt-dlp, Chrome, jq) mas oferece multiplas fontes e avaliação automática de confiabilidade.
README
A tradução para o português deste README ainda está na fila.
research-note
A Claude Code skill that researches any topic and generates a footnoted Markdown note with source quality assessment and optional Mermaid mindmaps.
Features
- Multi-source research: Web search, YouTube transcripts, PDFs, X/Twitter posts, GitHub repos
- Source quality tiers: Systematic reliability assessment (academic → encyclopedia → blog, official → media → aggregator)
- Footnoted output: Every factual claim backed by verified sources
- Mermaid mindmaps: Auto-generated for comparison and non-linear concept notes
- Headless Chrome fetching: Bundled
fetch-page.jsfor bot-protected pages - Native-language priority: Prefers local-language sources when researching specific countries
Installation
Copy this directory into your project's .claude/skills/ folder:
# Clone the repo
git clone https://github.com/eruto-skills/research-note.git
# Copy into your project
cp -r research-note /path/to/your-project/.claude/skills/research-note
Then install the Node.js dependencies for fetch-page.js:
cd /path/to/your-project/.claude/skills/research-note/scripts
npm install puppeteer-core turndown
System Dependencies
| Tool | Purpose | Install |
|---|---|---|
yt-dlp | YouTube transcript extraction | github.com/yt-dlp/yt-dlp |
curl | API calls | Usually pre-installed |
jq | JSON processing | jqlang.github.io/jq |
| Google Chrome / Chromium | Headless page fetching | google.com/chrome |
Usage
Slash command
/research-note quantum computing basics
/research-note https://www.youtube.com/watch?v=xxxxx
/research-note https://x.com/user/status/123456789
Natural language
- "Research this topic for me"
- "Summarize this YouTube video"
- "Read this PDF and make a note"
- "What is WebAssembly?"
Project Integration
The skill works out of the box, but you can customize it for your project by editing the "Project Integration" section in SKILL.md:
- File Placement: Define directory mapping rules so notes are automatically placed in the right location
- Lint: Specify a lint command (e.g.,
npx textlint) to run after note generation - Cross-Skill Integration: Connect with other skills in your project (quality checking, slide creation, article drafting)
File Structure
research-note/
├── README.md
├── LICENSE
├── SKILL.md # Main skill definition
├── scripts/
│ └── fetch-page.js # Headless Chrome page fetcher
├── references/
│ ├── source-acquisition.md # Per-source fetch commands & fallbacks
│ ├── source-quality-tiers.md # Source reliability criteria
│ ├── writing-conventions.md # Output formatting rules
│ └── qa-checklist.md # Quality verification checklist
└── assets/
└── note-template.md # Note skeleton template
License
MIT License. See LICENSE for details.
Support
If you find this skill useful, consider supporting its development:
Codex / Claude Code installation
This package supports both Codex and Claude Code. The plugin entry point is
skills/research-note/SKILL.md; the root SKILL.md remains the standalone source.
For Codex, add the public eruto-skills marketplace in the plugin UI using
https://github.com/eruto-skills/marketplace, then install research-note.
To install as a standalone user skill instead:
mkdir -p ~/.agents/skills
git clone https://github.com/eruto-skills/research-note.git ~/.agents/skills/research-note
On Windows PowerShell:
New-Item -ItemType Directory -Force "$env:USERPROFILE/.agents/skills" | Out-Null
git clone https://github.com/eruto-skills/research-note.git "$env:USERPROFILE/.agents/skills/research-note"
In Codex, select the installed skill by name or invoke $research-note with a task.
In Claude Code:
/plugin marketplace add eruto-skills/marketplace
/plugin install research-note@eruto-skills
The instructions use the tools available in the current host. Scripts are resolved
from the actual skill directory, rather than a fixed author path. Additional browser,
Python, or format-specific dependencies are described in SKILL.md and the references;
installing the plugin alone does not install those external programs.
Maintaining the plugin package
Edit the root SKILL.md and its supporting resources, then run:
node scripts/package-plugin.mjs
node scripts/package-plugin.mjs --check
Commit the generated skills/ files with the source changes. CI checks that both
layouts match, including the Claude manifest. Do not edit generated files directly.