Agent skill

researching-with-deepwiki

Research GitHub, GitLab, and Bitbucket repositories using DeepWiki MCP server. Use when exploring unfamiliar codebases, understanding project architecture, or asking questions about how a specific open-source project works. Provides AI-powered repo analysis and RAG-based Q&A about source code. NOT for fetching library API docs (use fetching-library-docs instead) or local files.

Stars 232
Forks 15

Install this agent skill to your Project

npx add-skill https://github.com/aiskillstore/marketplace/tree/main/skills/asmayaseen/researching-with-deepwiki

SKILL.md

Researching with DeepWiki

Research and understand codebases using the DeepWiki MCP server.

MCP Server Setup

Add to your Claude Code settings:

bash
claude mcp add -s user -t http deepwiki https://mcp.deepwiki.com/mcp

Or add to settings.json:

json
{
  "mcpServers": {
    "deepwiki": {
      "type": "http",
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}

Private Repositories

For private repos, use the Devin.ai endpoint with authentication:

json
{
  "mcpServers": {
    "deepwiki": {
      "type": "http",
      "url": "https://mcp.devin.ai/deepwiki/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_DEVIN_API_KEY"
      }
    }
  }
}

When to Use DeepWiki

Scenario Use DeepWiki?
Exploring unfamiliar open-source codebase Yes
Understanding project architecture Yes
Finding how a feature is implemented Yes
Generating documentation for a repo Yes
Working with your own local code No - use Glob/Grep
Quick file lookups in known structure No - use Read tool

Core Capabilities

1. Repository Analysis

Ask DeepWiki to analyze any public repository:

"Analyze the architecture of github.com/vercel/next.js"
"How is the routing system implemented in github.com/remix-run/react-router?"
"What design patterns are used in github.com/anthropics/anthropic-sdk-python?"

2. Code Structure Understanding

Get insights into project organization:

"Explain the directory structure of github.com/langchain-ai/langchain"
"What are the main modules in github.com/fastapi/fastapi?"
"How are tests organized in github.com/pytest-dev/pytest?"

3. Feature Investigation

Understand how specific features work:

"How does streaming work in github.com/openai/openai-python?"
"Where is authentication handled in github.com/better-auth/better-auth?"
"How are middleware implemented in github.com/honojs/hono?"

4. Architecture Visualization

DeepWiki can generate Mermaid diagrams:

"Generate an architecture diagram for github.com/prisma/prisma"
"Show the data flow in github.com/trpc/trpc"

Best Practices

1. Be Specific with Questions

# Good - specific question
"How does the caching system work in github.com/vercel/swr?"

# Less effective - too broad
"Tell me about github.com/vercel/swr"

2. Reference Specific Paths

# Good - targeted investigation
"Explain the src/core directory in github.com/pmndrs/zustand"

# Also good - feature-focused
"How is the middleware pattern implemented in github.com/pmndrs/zustand?"

3. Compare Implementations

"Compare how github.com/tanstack/query and github.com/vercel/swr handle cache invalidation"

4. Learn from Popular Projects

"What patterns from github.com/shadcn-ui/ui should I follow for my component library?"

Common Use Cases

Learning a New Framework

1. "Explain the core concepts of github.com/honojs/hono"
2. "How do I add middleware in github.com/honojs/hono?"
3. "Show example route handlers from github.com/honojs/hono"

Debugging Integration Issues

1. "How does github.com/drizzle-team/drizzle-orm handle connection pooling?"
2. "What error types are thrown by github.com/drizzle-team/drizzle-orm?"

Preparing for Contributions

1. "What's the contribution workflow for github.com/anthropics/claude-code?"
2. "How are issues labeled in github.com/anthropics/claude-code?"
3. "What testing patterns are used in github.com/anthropics/claude-code?"

Supported Platforms

Platform URL Format
GitHub github.com/owner/repo
GitLab gitlab.com/owner/repo
Bitbucket bitbucket.org/owner/repo

Limitations

  • Rate limits: Public endpoint has usage limits
  • Private repos: Requires Devin.ai API key
  • Large repos: May take time to analyze
  • Real-time changes: Cached analysis may not reflect latest commits

Verification

Run: python3 scripts/verify.py

Expected: ✓ DeepWiki MCP server configured

If Verification Fails

  1. Check: MCP server is configured in settings
  2. Test: Try a simple query like "analyze github.com/anthropics/anthropic-sdk-python"
  3. Stop and report if still failing

References

Expand your agent's capabilities with these related and highly-rated skills.

aiskillstore/marketplace

perigon-backend

Perigon ASP.NET Core + EF Core + Aspire conventions

232 15
Explore
aiskillstore/marketplace

perigon-agent

Pointers for Copilot/agents to apply Perigon conventions

232 15
Explore
aiskillstore/marketplace

perigon-angular

Angular 21+ standalone/Material/signal conventions for Perigon WebApp

232 15
Explore
aiskillstore/marketplace

fastapi-mastery

Comprehensive FastAPI development skill covering REST API creation, routing, request/response handling, validation, authentication, database integration, middleware, and deployment. Use when working with FastAPI projects, building APIs, implementing CRUD operations, setting up authentication/authorization, integrating databases (SQL/NoSQL), adding middleware, handling WebSockets, or deploying FastAPI applications. Triggered by requests involving .py files with FastAPI code, API endpoint creation, Pydantic models, or FastAPI-specific features.

232 15
Explore
aiskillstore/marketplace

context7-efficient

Token-efficient library documentation fetcher using Context7 MCP with 86.8% token savings through intelligent shell pipeline filtering. Fetches code examples, API references, and best practices for JavaScript, Python, Go, Rust, and other libraries. Use when users ask about library documentation, need code examples, want API usage patterns, are learning a new framework, need syntax reference, or troubleshooting with library-specific information. Triggers include questions like "Show me React hooks", "How do I use Prisma", "What's the Next.js routing syntax", or any request for library/framework documentation.

232 15
Explore
aiskillstore/marketplace

browser-use

Browser automation using Playwright MCP. Navigate websites, fill forms, click elements, take screenshots, and extract data. Use when tasks require web browsing, form submission, web scraping, UI testing, or any browser interaction.

232 15
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results