rename-and-organize-references

Propose and validate author-year-title file renames for academic references.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/errard70101/social-science-research-skills --skill rename-and-organize-references
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rename-and-organize-references
Source: https://github.com/errard70101/social-science-research-skills/tree/main/skills/rename-and-organize-references
Command: npx skills add https://github.com/errard70101/social-science-research-skills --skill rename-and-organize-references

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Use when academic paper PDFs, appendices, slides, or replication materials need consistent author-year-title filenames and a reviewed, safe reorganization plan.

Core Features & Use Cases

  • Propose, review, and apply deterministic filename renames for main papers and related materials based on metadata.
  • Validate proposed mappings against a structured mapping format and handle unresolved items for careful human review.
  • Integrate with existing metadata sources (PDF metadata, DOIs via OpenAlex) to derive accurate author, year, and title information.
  • Use a template-driven approach to generate filenames like [Authors][Year][Title] with optional suffixes for appendices/slides/replications; support offline mode.

Quick Start

Run the skill against your references folder to generate a proposed, reviewable mapping of filenames, then validate and apply it.

Frequently Asked Questions about rename-and-organize-references

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

FAQPage Schema
How do I rename academic PDFs with author-year-title filenames?▼

You can rename academic PDFs with author-year-title filenames by running this Skill against your references directory to propose a mapping, validate the schema, and apply the reviewed renames using metadata extracted via pypdf or OpenAlex DOI lookups.

Can I automatically rename appendices, slides, and replication materials along with the main paper?▼

Yes, you can rename appendices, slides, and replication materials alongside the main paper by using a template-driven approach that generates filenames with optional suffixes, applying consistent author-year-title formatting across all related academic files in your references directory.

How does the tool handle PDFs with missing or incomplete metadata for filename mapping?▼

For PDFs with missing metadata, the tool uses optional OpenAlex-based metadata lookups via DOI or title search to derive accurate author, year, and title information, outputting a schema-compliant mapping while isolating unresolved items for careful human review.

Do I need pypdf to parse PDFs and generate reference renaming mappings?▼

Yes, you need pypdf installed for PDF parsing to extract base metadata, but the Skill supports an offline mode for generating author-year-title filename mappings when external OpenAlex metadata lookups via DOI or title search are unavailable.

What is the best way to safely reorganize and standardize a references directory?▼

The best way to safely reorganize a references directory is to generate a proposed, reviewable mapping of author-year-title filenames first, validate the mapping against a structured format, handle unresolved items, and then apply the reviewed changes.