Custom Data Deep Research
Use this skill when the research corpus is not just the open web. The goal is to
turn private, semi-structured, or domain-specific sources into a cited corpus
that a deep research agent can inspect safely.
Workflow
- Define the research question and allowed sources.
- Export or read sources with read-only credentials.
- Convert each source into markdown or JSON plus metadata.
- Build an evidence manifest with stable IDs and offsets.
- Run the research agent over the allowed corpus.
- Normalize the report, findings, uncertainties, and method into OKF.
Source Guidance
| Source |
How to Use |
Citation Anchor |
| Google Docs / Drive |
Search/read Drive files, export Docs, preserve file IDs and revision times. |
file ID, title, URL, heading, revision timestamp |
| YouTube |
Pull transcript and metadata; prefer official captions. |
video URL, channel, upload date, timestamp range |
| Local files |
Crawl only allowlisted paths, hash files, convert PDFs/docs/text. |
relative path, sha256, modified time, page/line/heading |
| S3 |
Use read-only IAM, sync scoped prefixes, save object manifest. |
s3://bucket/key, version ID, ETag, row/page/byte offset |
| arXiv |
Fetch metadata and PDFs by arXiv ID and version. |
arXiv ID/version, authors, section/page |
| Databases / CSV |
Export query, schema, row counts, and sampled/aggregate evidence. |
query ID, table, primary key, aggregate definition |
Prompt Contract
Research question:
<question>
Allowed corpus:
<source IDs or OKF bundle paths>
Rules:
- Use only allowed sources unless public web supplementation is explicitly requested.
- Cite source ID plus exact anchor for every factual claim.
- Separate directly supported findings from inferences.
- Record missing, conflicting, stale, or low-confidence evidence.
- Return an OKF-compatible report.
Manifest Validation
Create a JSON manifest before indexing custom data. Validate it with:
python .agents/skills/deep-research-custom-data/scripts/validate_manifest.py \
staging/custom-corpus/manifest.json
The validator checks corpus metadata, supported source types, stable source IDs,
and citation anchors before a research agent uses the corpus.
Use docs/examples/custom-data-corpus.example.json as the minimal fixture for
benchmark and CI validation.
OKF Output
Use concept files for source records and research outputs:
sources/<source-id>.md with type such as Google Drive Document,
YouTube Transcript, Local File Evidence, S3 Object Evidence, or
Scholarly Paper.
claims/claim-register.md with type Evidence Claim Register.
method.md with type Research Method.
report.md, findings.md, and uncertainties.md for the final research
output.
See docs/custom-data-sources.md for detailed extraction and governance
guidance.
Safety
- Confirm authorization before accessing private data.
- Use read-only credentials and scoped folders, prefixes, or queries.
- Do not commit raw private extracts unless the repository is approved for that
data.
- Preserve retention/deletion requirements in
method.md.
1---2name: deep-research-custom-data3description: Build and validate custom-corpus inputs for deep research from Google Docs, YouTube, local files, S3, arXiv, databases, Slack, email, tickets, and similar non-web sources. Use when preparing private or domain-specific source manifests, validating source safety, or turning custom data into cited research inputs.4---56# Custom Data Deep Research78Use this skill when the research corpus is not just the open web. The goal is to9turn private, semi-structured, or domain-specific sources into a cited corpus10that a deep research agent can inspect safely.1112## Workflow13141. Define the research question and allowed sources.152. Export or read sources with read-only credentials.163. Convert each source into markdown or JSON plus metadata.174. Build an evidence manifest with stable IDs and offsets.185. Run the research agent over the allowed corpus.196. Normalize the report, findings, uncertainties, and method into OKF.2021## Source Guidance2223| Source | How to Use | Citation Anchor |24| --- | --- | --- |25| Google Docs / Drive | Search/read Drive files, export Docs, preserve file IDs and revision times. | file ID, title, URL, heading, revision timestamp |26| YouTube | Pull transcript and metadata; prefer official captions. | video URL, channel, upload date, timestamp range |27| Local files | Crawl only allowlisted paths, hash files, convert PDFs/docs/text. | relative path, sha256, modified time, page/line/heading |28| S3 | Use read-only IAM, sync scoped prefixes, save object manifest. | `s3://bucket/key`, version ID, ETag, row/page/byte offset |29| arXiv | Fetch metadata and PDFs by arXiv ID and version. | arXiv ID/version, authors, section/page |30| Databases / CSV | Export query, schema, row counts, and sampled/aggregate evidence. | query ID, table, primary key, aggregate definition |3132## Prompt Contract3334```text35Research question:36<question>3738Allowed corpus:39<source IDs or OKF bundle paths>4041Rules:42- Use only allowed sources unless public web supplementation is explicitly requested.43- Cite source ID plus exact anchor for every factual claim.44- Separate directly supported findings from inferences.45- Record missing, conflicting, stale, or low-confidence evidence.46- Return an OKF-compatible report.47```4849## Manifest Validation5051Create a JSON manifest before indexing custom data. Validate it with:5253```bash54python .agents/skills/deep-research-custom-data/scripts/validate_manifest.py \55 staging/custom-corpus/manifest.json56```5758The validator checks corpus metadata, supported source types, stable source IDs,59and citation anchors before a research agent uses the corpus.6061Use `docs/examples/custom-data-corpus.example.json` as the minimal fixture for62benchmark and CI validation.6364## OKF Output6566Use concept files for source records and research outputs:6768- `sources/<source-id>.md` with type such as `Google Drive Document`,69 `YouTube Transcript`, `Local File Evidence`, `S3 Object Evidence`, or70 `Scholarly Paper`.71- `claims/claim-register.md` with type `Evidence Claim Register`.72- `method.md` with type `Research Method`.73- `report.md`, `findings.md`, and `uncertainties.md` for the final research74 output.7576See `docs/custom-data-sources.md` for detailed extraction and governance77guidance.7879## Safety8081- Confirm authorization before accessing private data.82- Use read-only credentials and scoped folders, prefixes, or queries.83- Do not commit raw private extracts unless the repository is approved for that84 data.85- Preserve retention/deletion requirements in `method.md`.