topic-ingest

Archive Markdown digests into topic folders and update sources.md and timeline.md.

Updated Dec 17, 2025
One-click install
npx skills add https://github.com/haizhouyuan/codexreadpublic --skill topic-ingest
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: topic-ingest
Source: https://github.com/haizhouyuan/codexreadpublic/tree/main/skills-src/topic-ingest
Command: npx skills add https://github.com/haizhouyuan/codexreadpublic --skill topic-ingest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill moves digests or research outputs into the appropriate topic archives and keeps sources/timeline up to date, enabling ongoing topic tracking.

Core Features & Use Cases

  • Ensure digests land in archives/topics/<topic_id>/digests/
  • Update archives/topics/<topic_id>/sources.md and optionally timeline.md
  • Preserve references for traceability and future auditing

Quick Start

Provide a digest file path and a topic_id to archive it and refresh the topic’s sources/timeline.

Frequently Asked Questions about topic-ingest

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize research digests into topic archives?

Topic archiving automates organizing digests into `archives/topics/<topic_id>/digests/` folders, keeping research outputs structured by subject. The Skill validates file paths, copies digests to the correct location, and updates the topic's sources and timeline metadata automatically.

Can I automatically update sources and timeline when adding a digest to a topic?

Yes. When you archive a digest into a topic, the Skill runs an ingestion script that updates `sources.md` with references to the new digest and optionally refreshes `timeline.md`, maintaining a current record of all topic materials.

What file formats and paths does the digestion workflow accept?

The Skill accepts Markdown research files and digests from `archives/` or `exports/` directories. It validates input paths, ensures stable slug-based `topic_id` naming, and places processed files under the topic's digests folder with full traceability.

How do I ensure digests maintain references for future auditing?

Archiving digests into topic folders with automatic `sources.md` and `timeline.md` updates preserves a complete audit trail. Each digest is tracked by topic, enabling you to review what research was ingested, when, and for which subject area.

Does this work for ongoing topic tracking across multiple digests?

Yes. The Skill is designed for continuous topic tracking—add multiple digests over time and the sources and timeline stay synchronized automatically, supporting long-running research and knowledge accumulation workflows.