Python Filename Sanitization with Fallback

To sanitize a filename, this skill removes invalid characters like emoji and punctuation while preserving the original meaning. It validates the output to ensure the resulting filename always contains alphanumeric characters for safe filesystem indexing.

When sanitization leaves no valid characters, a metadata-driven fallback generates a descriptive name. It uses provided metadata like author, date, and category to ensure the filename remains unique and valid for document indexing.

Generating deterministic filenames ensures the same input title and metadata always produce the same output filename. This approach maintains backward compatibility by leaving existing valid filenames unchanged during the import process.

Yes, you can pass a metadata dictionary containing author, saved_at, and category details. If the title consists entirely of special characters, this metadata is used to construct a unique, descriptive fallback filename.

A limitation of filename sanitization is that titles consisting solely of whitespace or special characters cannot retain their original meaning. The skill must rely entirely on metadata or timestamp-based fallbacks to generate a valid name.