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.