Record the source-tracking `discovery` block on a research-corpus citation sidecar — where/how a paper was found (surface, via, curator). Runs via `aiwg corpus discovery-log`.
Installs into .claude/skills of the current project.
Are you the author of Discovery Log?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/jmagly-discovery-log)
---
namespace: aiwg
platforms: [all]
name: discovery-log
description: Record the source-tracking `discovery` block on a research-corpus citation sidecar — where/how a paper was found (surface, via, curator). Runs via `aiwg corpus discovery-log`.
commandHint:
argumentHint: "--ref REF-XXX --surface SURFACE [--via \"...\"] [--curator PROF-S-x] [--write]"
allowedTools: Read, Bash, Write
model: sonnet
category: research-discovery
---
# Discovery Log
Record *how a paper was discovered* — the optional `discovery:` block in a
citation sidecar's frontmatter (SOURCE-TRACKING schema). The read views
`by-source` / `by-curator` (#1492) consume this.
## How to run
```bash
aiwg corpus discovery-log --ref REF-640 --surface x-account --via "x.com/@askalphaxiv" --curator PROF-S-askalphaxiv # dry-run (prints the block)
aiwg corpus discovery-log --ref REF-640 --surface x-account --via "x.com/@askalphaxiv" --curator PROF-S-askalphaxiv --write # splice into the sidecar
aiwg corpus discovery-log --ref REF-641 --surface x-search --write # surface only, no curator
```
- Adds or **replaces** the `discovery:` block in the sidecar frontmatter,
preserving the rest of the file. Dry-run unless `--write`.
- `--surface` (required) vocab: `x-account | x-search | x-bookmarks | x-foryou |
x-following | rss | newsletter | web | referral | direct`.
- `--curator` (optional) is a `PROF-S-` id; set it only when the source came
through a named, repeatable curator. Omit for `direct`/search-found papers
(`curator-id: null`). The block is OPTIONAL by design — absence is never an error.
> Distinct from radar `sources-searched` (surfaces queried during a freshness
> refresh): `discovery` records where a paper was *originally found*.
## Triggers
- "log how we found REF-XXX"
- "record the discovery source for this paper"
- "set the curator for REF-XXX"
- `/discovery-log`
## References
- @$AIWG_ROOT/src/artifacts/corpus-tools/discovery-log.ts — implementation
- curator-status / curator-init skills; @$AIWG_ROOT/agentic/code/frameworks/research-complete/docs/source-tracking.md — schema
