moonlight-lupin/agent-skills / research/deep-research
deep-research
VerifiedUse when the user asks for "deep research", a "research report on", a "comprehensive analysis of", to "look into X in depth", to "write a report on X", or any question needing multi-source synthesis beyond a single search — an autonomous multi-step deep research engine implementing an iterative Think → Search → Extract → Synthesize → Stop loop. The LLM drives every decision: what to search, what's relevant, what's missing, and when to stop. Produces a cited, magazine-quality report with inline citations, category-specific formatting, and research stats. For entity vetting/dossiers use entity-research; for news digests use news-monitoring; for source-grounded Q&A use notebooklm-mode.
references/citation-schema.md
View on GitHub# Source Record Schema
Citation database stores records in a SQLite table named `sources`. Each row is one
canonical cited URL. URL variants can be merged by the dedup workflow.
```sql
CREATE TABLE IF NOT EXISTS sources (
id INTEGER PRIMARY KEY AUTOINCREMENT,
url TEXT NOT NULL UNIQUE,
url_normalized TEXT NOT NULL,
title TEXT,
topic TEXT NOT NULL,
source_type TEXT DEFAULT 'web',
accessed_at TEXT NOT NULL,
notes TEXT,
verified INTEGER DEFAULT 1,
last_checked TEXT,
session_id TEXT
);
CREATE INDEX IF NOT EXISTS idx_topic ON sources(topic);
CREATE INDEX IF NOT EXISTS idx_normalized ON sources(url_normalized);
```
## Fields
| Field | SQLite type | Required | Constraints | Usage notes |
|---|---:|---:|---|---|
| `id` | `INTEGER` | Yes | Primary key, autoincrement. | Internal stable row identifier. Use for debugging, exports, and update targeting. |
| `url` | `TEXT` | Yes | Unique. Stored as canonical URL. | The visible citation URL. Canonicalization lowercases scheme/host, strips fragments, strips default ports, and trims trailing slash on non-root paths. |
| `url_normalized` | `TEXT` | Yes | Indexed, not unique. | Normalized URL field reserved for lookup/dedup support. Dedup also computes a comparison key that ignores scheme and leading `www.`. |
| `title` | `TEXT` | No | May be `NULL`. | Human-readable source title. Provide explicitly with `--title` for important citations; otherwise the add command tries a best-effort HTML `<title>` fetch. |
| `topic` | `TEXT` | Yes | Indexed. | Topic tag used for search, stats, and export. Keep topic strings consistent across sessions. |
| `source_type` | `TEXT` | No | Defaults to `web`. Expected values: `web`, `pdf`, `api`, `dataset`, `book`, `news`, `report`. | Helps filter source lists and distinguish citation classes. |
| `accessed_at` | `TEXT` | Yes | ISO date (`YYYY-MM-DD`). | Date the source was added/cited. Dedup keeps the earliest date among merged variants. |
| `notes` | `TEXT` | No | May be `NULL`. | Short explanation of why the source matters. Dedup combines unique non-empty notes from merged rows. |
| `verified` | `INTEGER` | No | `1` for alive/verified, `0` for dead/unverified. Defaults to `1`. | Health checker updates this flag. Export includes it for auditability. |
| `last_checked` | `TEXT` | No | ISO date (`YYYY-MM-DD`) or `NULL`. | Last date `url_health.py` checked the URL. `NULL` means never checked after insertion. |
| `session_id` | `TEXT` | No | Free-form string. | Optional research session, vault, project, or run identifier. Useful when one topic spans many sessions. |
## Source Type Values
- `web` — standard web page, documentation, blog post, landing page.
- `pdf` — direct PDF URL or page where the PDF is the source of record.
- `api` — API endpoint or machine-readable service response.
- `dataset` — public data catalog or downloadable data file.
- `book` — online book, chapter, scan, or bibliographic record.
- `news` — news article, wire story, interview, or live blog.
- `report` — white paper, government report, analyst note, or institutional report.
## Normalization Notes
`url` is canonicalized for storage, while dedup computes an additional comparison
key at runtime. The comparison key collapses these variants:
- `http` and `https` versions of the same host/path/query.
- Hosts with and without a leading `www.` prefix.
- URLs that differ only by fragment (`#section`).
- Non-root paths that differ only by a trailing slash.
Query strings are preserved because they can identify distinct documents or API
responses.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |