raw-article-filename-policy

Generate date-based filenames for academic papers and lecture transcripts.

7|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/kzinmr/ai-topics --skill raw-article-filename-policy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: raw-article-filename-policy
Source: https://github.com/kzinmr/ai-topics/tree/main/config/hermes/skills/_overrides/raw-article-filename-policy
Command: npx skills add https://github.com/kzinmr/ai-topics --skill raw-article-filename-policy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Ensures standardized naming for academic papers and lecture transcripts stored in the knowledge base repository.

Core Features & Use Cases

  • Academic Paper Naming: Automatically generates filenames for academic papers following the convention {YYYY-MM-DD}_{arxiv-id}_{short-title}.md.
  • Lecture Transcript Naming: Names lecture transcripts according to the convention {YYYY-MM-DD}_{source-slug}_{content-slug}-lecture.md.
  • Duplicate Check: Before saving, verifies if the paper already exists in the repository to prevent duplicates.
  • Metadata Updates: Allows updates to filenames if dates or titles are corrected.

Quick Start

When saving a new paper, run the command: python3 scripts/papers_index.py --check <arxiv-url-or-id> and ensure it is not a duplicate. Then save the paper with the correct naming format.

Frequently Asked Questions about raw-article-filename-policy

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

FAQPage Schema
How do I name academic papers in a knowledge base repository?▼

Academic paper naming follows the convention `{YYYY-MM-DD}_{arxiv-id}_{short-title}.md` to ensure consistent filenames. This format utilizes publication dates, arXiv IDs, and short titles to maintain standardized records across your repository.

What is the correct file naming convention for lecture transcripts?▼

Lecture transcript naming uses the format `{YYYY-MM-DD}_{source-slug}_{content-slug}-lecture.md`. This convention applies specific dates and source slugs to keep lecture records organized and distinct from academic papers in the knowledge base.

How do I check for duplicate academic papers before saving to the repository?▼

Run `python3 scripts/papers_index.py --check <arxiv-url-or-id>` to check for duplicate papers before saving. This verifies database integrity by ensuring the submitted paper does not already exist in your repository.

Do I need Python3 to implement file naming conventions for academic papers?▼

Yes, Python3 is required to run the scripts that implement file naming conventions. The repository maintenance scripts depend on Python3 to generate filenames and perform duplicate checks for academic papers and lecture transcripts.

Can I update academic paper filenames if dates or titles are corrected?▼

Yes, metadata updates allow you to correct filenames when dates or titles change. This ensures that the generated filenames for academic papers remain accurate and consistent even after initial repository submission.