convez.ai
SkillBusca & PesquisaIntermediário
eruto-skills

Research Note

eruto-skills/research-note

Pesquisa multifontes com notas footnoted e avaliação de qualidade

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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-note

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

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.js for 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

ToolPurposeInstall
yt-dlpYouTube transcript extractiongithub.com/yt-dlp/yt-dlp
curlAPI callsUsually pre-installed
jqJSON processingjqlang.github.io/jq
Google Chrome / ChromiumHeadless page fetchinggoogle.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.

Ver o original no GitHub

Bom para

Relacionados