القائمة
Use when an agent needs to search the web, find images/news/videos/books, or extract content from a URL. Covers the ddgs Python library, CLI, and MCP server integration.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
A living, self-improving cognitive architecture that thinks, learns, remembers, adapts, and evolves — permanently. Use for ANY task where quality must compound over time: code, analysis, writing, debugging, research, planning, design, or multi-step workflows. ALWAYS trigger when: the task feels familiar, mistakes must not repeat, quality must exceed previous work, the user signals frustration ("you always get this wrong", "remember last time", "learn from this"), or when the task is complex enough that experience should shape the approach. This is not a skill. It is a mind that grows with every task it touches. The longer it runs, the smarter it becomes.
A self-review skill that attacks Mirage's own output from four adversarial perspectives — security researcher, failure analyst, scale engineer, and future maintainer — before presenting it to the developer. Also enforces explicit uncertainty quantification on every claim: distinguishing what is verified, inferred, or hypothetical. ALWAYS activate after any implementation of: authentication, payment logic, data mutations, file handling, external API calls, or any feature the developer has flagged as high-stakes. Also activate when the developer asks "is this safe?", "will this scale?", "what could go wrong?", or "are you sure about this?" This skill is the difference between Mirage presenting its first draft and presenting a production-ready implementation that has already been internally stress-tested.
A deep structural intelligence layer that builds and queries a living model of any codebase — its dependency graph, semantic index, git history, defect density, coupling patterns, and hidden invariants. ALWAYS activate when: starting work on an unfamiliar codebase, before any refactoring or architectural change, before touching files that have a history of instability, when asked "what will break if I change X", or when the task requires understanding how parts of the system relate to each other. This skill transforms Mirage from an agent that reads files to one that understands systems. It is the structural memory layer — where adaptive-mind is episodic memory of what happened, codebase-archaeologist is semantic memory of what exists and how it connects.
A structured reasoning skill that generates competing hypotheses, designs falsification tests, eliminates candidates with evidence, and — for high-stakes architectural decisions — runs a multi-perspective debate where each perspective actively tries to break the proposal. ALWAYS activate for: any bug where the root cause is not immediately obvious, any architectural decision that is difficult to reverse, any situation where the first explanation feels too convenient, or when asked "why is this happening" or "which approach should we take". This skill is the antidote to the Einstellung Effect — it prevents the most familiar solution from blocking the best one. It makes Mirage reason like a scientist and decide like a senior engineering committee.
The teaching and knowledge-deepening layer of the adaptive-mind system. Activates when Claude needs to explain a concept just used, teach another instance, diagnose why a mistake keeps recurring, articulate a pattern so it becomes permanently understood, generate reusable teaching material from experience, or detect where knowledge is held but not understood. ALWAYS activate in combination with adaptive-mind. ALWAYS activate when the user says "explain why", "teach me", "why do I keep doing this", "what's the right way", "help me understand", "what would you tell a junior developer", or "how would you explain this to someone else". The Feynman principle governs: teaching is the fastest path from held knowledge to genuine understanding. The more Claude teaches, the deeper it understands. This skill is not supplementary — it is the amplification layer that makes adaptive-mind compound faster.
استنادا إلى تصنيف SOC المهني
| name | ddgs |
| description | Use when an agent needs to search the web, find images/news/videos/books, or extract content from a URL. Covers the ddgs Python library, CLI, and MCP server integration. |
ddgs (Dux Distributed Global Search) is a Python metasearch library that aggregates results from multiple search engines. Agents can use it via Python API, CLI, or MCP server.
from ddgs import DDGS
# Text search
results = DDGS().text("python async", max_results=5)
# Images, news, videos, books
images = DDGS().images("butterfly", max_results=5)
news = DDGS().news("ai regulation", timelimit="w")
videos = DDGS().videos("rust programming")
books = DDGS().books("machine learning")
# Extract content from a URL
page = DDGS().extract("https://example.com")
page["content"] # Markdown text (default)
page = DDGS().extract("https://example.com", fmt="text_plain")
page = DDGS().extract("https://example.com", fmt="content") # raw bytes
All search methods return list[dict[str, Any]]. Each dict has keys depending on category:
| Method | Keys |
|---|---|
text() | title, href, body |
images() | title, image, thumbnail, url, height, width, source |
videos() | title, content, description, duration, embed_url, images, publisher |
news() | date, title, body, url, image, source |
books() | title, author, publisher, info, url, thumbnail |
# Text search
ddgs text -q "python async" --max_results 5
# Other categories
ddgs images -q "cats" --color Blue
ddgs news -q "tech" --timelimit d
ddgs videos -q "cars" --duration medium
ddgs books -q "sea wolf"
# Extract content
ddgs extract -u https://example.com
ddgs extract -u https://example.com -f text_plain
# Save results
ddgs text -q "dogs" -o results.json
ddgs text -q "dogs" -o results.csv
# Version
ddgs version
Agents can also use ddgs as a CLI tool via subprocess. Auto-detects non-TTY — outputs plain text without colors or interactive pauses.
To discover available options:
ddgs --help
ddgs text --help
ddgs images --help
pip install ddgs[mcp]
ddgs mcp # stdio MCP server
ddgs mcp -pr socks5h://127.0.0.1:9150 # with proxy
Client configuration:
{
"mcpServers": {
"ddgs": {
"command": "ddgs",
"args": ["mcp"]
}
}
}
| Tool | Description |
|---|---|
search_text | Web text search |
search_images | Image search |
search_news | News search |
search_videos | Video search |
search_books | Book search |
extract_content | Extract content from a URL |
| Parameter | Values | Default |
|---|---|---|
region | us-en, uk-en, ru-ru, de-de, etc. | us-en |
safesearch | on, moderate, off | moderate |
timelimit | d (day), w (week), m (month), y (year) | None |
max_results | int | 10 |
page | int | 1 |
backend | auto, all, or engine name | auto |
Available backends by method:
| Method | Backends |
|---|---|
text() | bing, brave, duckduckgo, google, grokipedia, mojeek, yandex, yahoo, wikipedia |
images() | bing, duckduckgo |
videos() | duckduckgo |
news() | bing, duckduckgo, yahoo |
books() | annasarchive |
DDGS(proxy="socks5h://127.0.0.1:9150") or set env DDGS_PROXYddgs mcp -pr socks5h://127.0.0.1:9150 or export DDGS_PROXY=...ddgs api -pr socks5h://127.0.0.1:9150 or export DDGS_PROXY=...DDGS(verify=False) or DDGS(verify="/path/to/cert.pem")DDGS(timeout=10) (default: 5 seconds)DDGSException, RatelimitException, TimeoutExceptionbackend="bing,google" (comma-separated)