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.
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:
claude mcp add -s user -t http deepwiki https://mcp.deepwiki.com/mcp
Or add to settings.json:
{
"mcpServers": {
"deepwiki": {
"type": "http",
"url": "https://mcp.deepwiki.com/mcp"
}
}
}
Private Repositories
For private repos, use the Devin.ai endpoint with authentication:
{
"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
- Check: MCP server is configured in settings
- Test: Try a simple query like "analyze github.com/anthropics/anthropic-sdk-python"
- Stop and report if still failing
References
- DeepWiki - Main service
- MCP endpoint - Public MCP server
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
perigon-backend
Perigon ASP.NET Core + EF Core + Aspire conventions
perigon-agent
Pointers for Copilot/agents to apply Perigon conventions
perigon-angular
Angular 21+ standalone/Material/signal conventions for Perigon WebApp
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.
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.
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.
Didn't find tool you were looking for?