agentleFS
tansuasicitansuasici/claude-research-kit/.claude/skills/lit-briefing/SKILL.md

lit-briefing

Skill4 starsChanged 6 months agoMITView on GitHub

A short "since last time" briefing from vault/log.md + vault/index.md — recently ingested sources, open follow-ups and citation-chaining leads, and gaps relative to MANUSCRIPT_MAP.md → Thesis (themes the argument needs that the library lacks). Read-only; outputs a tight briefing whose gaps become search directions for /literature-review. Never fabricates a source to fill a gap.

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 0 are distinctive, and 8 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 8

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Before a /literature-review session, to know which themes the synthesis can support and which it must flag as gaps.

    line 24
  2. Very specific:

    After a run of /lit-ingest, to step back and see whether the new sources actually moved the argument forward.

    line 27
  3. Very specific:

    Read-only. The one persistent side effect is maintaining vault/index.md → ## Open gaps (relative to the thesis) so the gap list survives …

    line 30
  4. Very specific:

    Read MANUSCRIPT_MAP.md → Thesis, Contribution, and Key sources — the argument the library exists to support, and the spine references it …

    line 38
  5. Very specific:

    Read vault/log.md — the append-only activity record.

    line 40
  6. Very specific:

    Read vault/index.md — the current roster of sources, concepts, entities, and the standing "Open gaps" list.

    line 43
  7. Very specific:

    Keep it to what actually changed — this is a "since last time" delta, not a full inventory (that is /lit-lint's job).

    line 55
  8. Very specific:

    If the thesis itself has drifted (the gaps no longer match the argument), that is a finding worth surfacing — the briefing measures the …

    line 151

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Lit-Briefing

Core Rule

A briefing reports the state of the library against the argument — what came in, what is still open, and where the thesis outruns the evidence. The gaps it names are search directions (themes to go find real sources for), never fabricated sources to fill the hole. "The argument needs work on horizon-scaling of hallucinated tool calls and the library has none" is the honest output — not an invented citation that pretends the gap is closed. This is a read-only synthesis of vault/log.md, vault/index.md, and the summaries; it writes nothing except (optionally) the maintained gap list in the index.

When to Use

Invoke with /lit-briefing when:

  • Resuming work after time away — "what did I ingest, what was I chasing?"
  • Before a /literature-review session, to know which themes the synthesis can support and which it must flag as gaps.
  • Planning a literature-search session — the gaps become the search queries.
  • After a run of /lit-ingest, to step back and see whether the new sources actually moved the argument forward.

Read-only. The one persistent side effect is maintaining vault/index.md → ## Open gaps (relative to the thesis) so the gap list survives between sessions.

Process

Phase 1 — Load the argument and the timeline

  1. Read MANUSCRIPT_MAP.md → Thesis, Contribution, and Key sources — the argument the library exists to support, and the spine references it must not misattribute.
  2. Read vault/log.md — the append-only activity record. Identify the most recent entries (ingests, lints, prior briefings) since the last briefing, or over a sensible recent window.
  3. Read vault/index.md — the current roster of sources, concepts, entities, and the standing "Open gaps" list.

Phase 2 — "Since last time": recent activity

From the tail of vault/log.md:

  • Recently ingested sources — list them with cite key + one-line "what it establishes", pulled from each summary's ## Summary. Note status: (a fresh metadata-only page is an ingest that still needs the full text).
  • Recent lint findings — if a /lit-lint ran, surface any unresolved orphans or contradictions it logged.
  • Keep it to what actually changed — this is a "since last time" delta, not a full inventory (that is /lit-lint's job).

Phase 3 — Open follow-ups & citation-chaining leads

Sweep the Open questions / follow-ups sections of recently touched summaries (and any concepts/ "Open gap" fields):

  • Citation-chaining leads — papers a source cites that are worth fetching ("backward-cite from [[doe2023tooluse]]"), or later work by an author already in the vault.
  • Verification debts — [VALUE — verify] fields and metadata-only pages still awaiting full text.
  • Threads — questions an ingest raised that no current source answers.

Each lead is a concrete next action, not a vague "read more."

Phase 4 — Gap analysis against the thesis

This is the heart of the briefing. For each theme the argument needs (derived from MANUSCRIPT_MAP.md → Thesis / Contribution / Key sources), check whether the library actually covers it:

  • Covered — a read source in the vault supports it (name the cite key).
  • Thin — only a metadata-only / skimmed page, or a single source carrying more weight than it can bear.
  • Missing — no source in the library bears on it at all.

For every thin or missing theme, emit a search direction — what to look for, never a fabricated paper:

  • Keywords / queries to run (e.g. "constrained decoding tool use", "self-consistency verification agents").
  • Venues & years likely to hold it (e.g. NeurIPS / ICLR / ACL 2023–2025).
  • Citation chaining from a paper already in the vault.

Maintain these in vault/index.md → ## Open gaps (relative to the thesis) so they persist. The loop stays honest: you fetch a result → /lit-ingest it → re-run the briefing; the skill never closes a gap by inventing a source.

Phase 5 — Assemble the briefing

Produce the tight briefing below. Keep it short — a briefing is read in under a minute. The gaps are formatted so they can be handed straight to /literature-review as search directions.

Output Format

# Lit-Briefing — 2026-06-03

## Since last time (3 ingests)
- [[doe2023tooluse]] — tool use works on single-turn QA (read)
- [[halluc2022]] — hallucination prevalent in LLMs (metadata-only — full text still needed)
- [[gate2024]] — pre-execution gate reduces hallucinated tool calls, one harness (read)

## Open follow-ups & citation-chaining leads
- Backward-cite from [[gate2024]] — it cites a multi-turn agent benchmark we lack.
- [[halluc2022]] is metadata-only — fetch the PDF to license its findings.
- Thread: does any source measure hallucinated-call rate vs. task horizon? (none yet)

## Gaps relative to the thesis
| Theme the argument needs | Library status | Search direction |
|--------------------------|----------------|------------------|
| Multi-turn agentic tool-call evaluation | missing | "multi-turn agent benchmark tool use", NeurIPS/ICLR 2023–2025 |
| Pre-execution vs. post-hoc verification | thin (gate2024 only) | "self-correction LLM agents", backward-cite from [[gate2024]] |
| Hallucinated-call rate vs. horizon | missing | "tool-call error rate task horizon", ACL 2024–2025 |

## Suggested next move
Fetch a multi-turn agentic eval benchmark (biggest unmet need for the thesis), /lit-ingest it,
then re-run /literature-review.

End by noting the count (covered / thin / missing) themes — the same honest gap framing /literature-review reports. Never present a gap as closed by a source you cannot point to.

Pairs With

  • /literature-review — the direct consumer: the briefing's gaps become its search directions, and a covered theme tells it what it can synthesize from read sources.
  • /lit-ingest — the action a follow-up or gap implies: fetch the real source, ingest it, re-brief.
  • /lit-lint — run before briefing so orphans/contradictions do not pollute the gap picture; lint = structural health, briefing = argument coverage.
  • MANUSCRIPT_MAP.md — the source of truth for the thesis the gaps are measured against; if the thesis shifts, the gaps shift.

Notes

  • Read-only, save for maintaining vault/index.md → ## Open gaps. The briefing reads the log and index; it does not ingest, lint, or edit sources/.
  • A gap is a search direction, never a fabricated source. The cardinal rule applies: the honest output is "the library lacks X — here is how to find it," not an invented \cite.
  • Distinguish three coverage states plainly — covered / thin / missing — so the author knows which themes the draft can lean on and which it must flag.
  • Gap analysis against the thesis is Reasoner-tier synthesis (see CLAUDE.md → Model Selection); reading the log tail is mechanical.
  • If the thesis itself has drifted (the gaps no longer match the argument), that is a finding worth surfacing — the briefing measures the library against MANUSCRIPT_MAP.md, so stale gaps can mean a stale map.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.