Skills Agentes

Github Deep Research

Investigación multi-ronda sobre cualquier repositorio de GitHub. Se activa con URLs de repos o proyectos open source y produce informes Markdown con resúmenes ejecutivos, cronologías, métricas y diagramas Mermaid.

Estrellas
82.8k

en todo el repo

Actividad
35

0–100, la ruta de este skill

Actualizado
hace 6 meses

último commit aquí

Commits
0

últimos 90 días

Contexto
1.3k tok

93 tok en reposo

Paquete
3 archivos

20 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add bytedance/deer-flow --skill github-deep-research --agent claude-code

Se instala solo en este repositorio.

Este skill makes network requests, needs API credentials.

Qué hace

  • Investiga en profundidad un repositorio de GitHub combinando la API de GitHub, búsqueda web y web_fetch en 4 rondas (API, descubrimiento, investigación, deep dive).
  • Analiza el historial de commits, issues, PRs y contribuidores para reconstruir una cronología de eventos.
  • Genera un informe Markdown estructurado con resumen ejecutivo, cronología, métricas, comparaciones y diagramas Mermaid.
  • Asigna un nivel de confianza (alto/medio/bajo) a cada hallazgo según la calidad de la fuente.

Úsalo cuando

  • El usuario pide un análisis exhaustivo, reconstrucción de cronología o análisis competitivo de un repositorio de GitHub.
  • Comparte una URL de un repositorio de GitHub o proyecto open source y pide una investigación en profundidad.

No lo uses cuando

    Qué lo activa

    Di cualquiera de estas frases y el agente debería cargar este skill.

    • “Haz una investigación profunda del repositorio facebook/react”
    • “Reconstruye la cronología de este proyecto open source en GitHub”
    • “Analiza a fondo este repo y compáralo con sus alternativas”

    SKILL.md

    En inglés

    GitHub Deep Research Skill

    Multi-round research combining GitHub API, web_search, web_fetch to produce comprehensive markdown reports.

    Research Workflow

    • Round 1: GitHub API
    • Round 2: Discovery
    • Round 3: Deep Investigation
    • Round 4: Deep Dive

    Core Methodology

    Query Strategy

    Broad to Narrow: Start with GitHub API, then general queries, refine based on findings.

    Round 1: GitHub API
    Round 2: "{topic} overview"
    Round 3: "{topic} architecture", "{topic} vs alternatives"
    Round 4: "{topic} issues", "{topic} roadmap", "site:github.com {topic}"
    

    Source Prioritization:

    1. Official docs/repos (highest weight)
    2. Technical blogs (Medium, Dev.to)
    3. News articles (verified outlets)
    4. Community discussions (Reddit, HN)
    5. Social media (lowest weight, for sentiment)

    Research Rounds

    Round 1 - GitHub API Directly execute scripts/github_api.py without read_file():

    python /path/to/skill/scripts/github_api.py <owner> <repo> summary
    python /path/to/skill/scripts/github_api.py <owner> <repo> readme
    python /path/to/skill/scripts/github_api.py <owner> <repo> tree
    

    Available commands (the last argument of github_api.py):

    • summary
    • info
    • readme
    • tree
    • languages
    • contributors
    • commits
    • issues
    • prs
    • releases

    Round 2 - Discovery (3-5 web_search)

    • Get overview and identify key terms
    • Find official website/repo
    • Identify main players/competitors

    Round 3 - Deep Investigation (5-10 web_search + web_fetch)

    • Technical architecture details
    • Timeline of key events
    • Community sentiment
    • Use web_fetch on valuable URLs for full content

    Round 4 - Deep Dive

    • Analyze commit history for timeline
    • Review issues/PRs for feature evolution
    • Check contributor activity

    Report Structure

    Follow template in assets/report_template.md:

    1. Metadata Block - Date, confidence level, subject
    2. Executive Summary - 2-3 sentence overview with key metrics
    3. Chronological Timeline - Phased breakdown with dates
    4. Key Analysis Sections - Topic-specific deep dives
    5. Metrics & Comparisons - Tables, growth charts
    6. Strengths & Weaknesses - Balanced assessment
    7. Sources - Categorized references
    8. Confidence Assessment - Claims by confidence level
    9. Methodology - Research approach used

    Mermaid Diagrams

    Include diagrams where helpful:

    Timeline (Gantt):

    gantt
        title Project Timeline
        dateFormat YYYY-MM-DD
        section Phase 1
        Development    :2025-01-01, 2025-03-01
        section Phase 2
        Launch         :2025-03-01, 2025-04-01
    

    Architecture (Flowchart):

    flowchart TD
        A[User] --> B[Coordinator]
        B --> C[Planner]
        C --> D[Research Team]
        D --> E[Reporter]
    

    Comparison (Pie/Bar):

    pie title Market Share
        "Project A" : 45
        "Project B" : 30
        "Others" : 25
    

    Confidence Scoring

    Assign confidence based on source quality:

    Confidence Criteria
    High (90%+) Official docs, GitHub data, multiple corroborating sources
    Medium (70-89%) Single reliable source, recent articles
    Low (50-69%) Social media, unverified claims, outdated info

    Output

    Save report as: research_{topic}_{YYYYMMDD}.md

    Formatting Rules

    • Chinese content: Use full-width punctuation(,。:;!?)
    • Technical terms: Provide Wiki/doc URL on first mention
    • Tables: Use for metrics, comparisons
    • Code blocks: For technical examples
    • Mermaid: For architecture, timelines, flows

    Best Practices

    1. Start with official sources - Repo, docs, company blog
    2. Verify dates from commits/PRs - More reliable than articles
    3. Triangulate claims - 2+ independent sources
    4. Note conflicting info - Don't hide contradictions
    5. Distinguish fact vs opinion - Label speculation clearly
    6. CRITICAL: Always include inline citations - Use [citation:Title](URL) format immediately after each claim from external sources
    7. Extract URLs from search results - web_search returns {title, url, snippet} - always use the URL field
    8. Update as you go - Don't wait until end to synthesize

    Citation Examples

    Good - With inline citations:

    The project gained 10,000 stars within 3 months of launch [citation:GitHub Stats](https://github.com/owner/repo).
    The architecture uses LangGraph for workflow orchestration [citation:LangGraph Docs](https://langchain.com/langgraph).
    

    Bad - Without citations:

    The project gained 10,000 stars within 3 months of launch.
    The architecture uses LangGraph for workflow orchestration.
    

    Reproducido de bytedance/deer-flow bajo licencia MIT. Leer esta página en markdown.

    Archivos

    3 archivos en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

    Antes de instalar

    Necesita acceso al script `scripts/github_api.py` y a herramientas de web_search/web_fetch.

    Necesita en el PATH:python

    Variables de entorno:GITHUB_TOKEN

    Detalles

    Creador
    bytedance
    Categoría
    Investigación
    Licencia
    MIT
    Recursos incluidos
    scripts en python
    Código fuente
    Ver SKILL.md

    Etiquetas

    Más de bytedance/deer-flow

    Este repo incluye 27 skills. Si instalas uno, normalmente ya tienes los demás. Ver el pack deer-flow entero y su comando de instalación

    Evalúa y ejecuta cambios de sistema no triviales desde primeros principios: RFCs, features, refactors, migraciones o nuevas APIs, exigiendo consumidores concretos, la solución mínima suficiente y evidencia proporcional al riesgo.

    Costo de contexto al activarse
    2.5k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 2 meses
    herramientas desarrollo

    Revisa paquetes de skills de DeerFlow: preparación para publicar, triggers, límites de seguridad, recursos y evidencia. Úsala cuando pidan auditar, calificar o validar para producción una skill.

    Costo de contexto al activarse
    1.4k tok
    Tamaño del paquete
    13 archivos
    Última actualización
    hace 3 meses
    herramientas desarrollo

    Crea skills nuevas, modifica y mejora skills existentes, y mide su rendimiento. Úsala para crear una skill, editarla, correr evals, hacer benchmark con análisis de varianza, u optimizar su descripción.

    Costo de contexto al activarse
    9.2k tok
    Tamaño del paquete
    20 archivos
    Última actualización
    hace 3 meses
    herramientas desarrollo

    Skill de smoke test de extremo a extremo para DeerFlow: actualiza el código, despliega en local o Docker, verifica disponibilidad de servicios, hace health check y genera el reporte final.

    Costo de contexto al activarse
    2.5k tok
    Tamaño del paquete
    12 archivos
    Última actualización
    hace 3 meses
    testing qa

    Manejo de issues y PRs de GitHub solo por comentarios para mantenedores de DeerFlow: resuelve alcance con gh, analiza, publica o redacta comentarios de issues y revisiones de PR, y compara PRs en competencia.

    Costo de contexto al activarse
    5.4k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 3 meses
    herramientas desarrollo

    Asegura que el código async del backend que podría bloquear el event loop de asyncio quede protegido por un test 'anchor' verificado en tests/blocking_io/, mediante un escaneo determinista de cambios o de todo el repo.

    Costo de contexto al activarse
    1.7k tok
    Tamaño del paquete
    4 archivos
    Última actualización
    hace 3 meses
    testing qa

    Skills relacionados

    Úsalo cuando el usuario pida revisar, analizar, criticar o resumir papers académicos, artículos de investigación, preprints o publicaciones científicas, con reviews estructuradas al estilo de las mejores conferencias.

    Costo de contexto al activarse
    3k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 6 meses
    investigacion

    Genera informes de investigación de nivel consultoría (mercado, marca, finanzas, industria, due diligence) en dos fases: framework de análisis y luego informe final con narrativas, gráficos e insights estratégicos.

    Costo de contexto al activarse
    8.4k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 7 meses
    investigacion

    Úsala en vez de WebSearch para cualquier pregunta que requiera investigación web: 'qué es X', 'explica X', 'compara X e Y' o antes de generar contenido. Aplica investigación sistemática multi-ángulo en vez de búsquedas superficiales.

    Costo de contexto al activarse
    2k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 7 meses
    investigacion