Engineering
add avatar

add

Automated curation agent for Neovim plugins: classifies, validates, and integrates new repository entries into categorized documentation.

Introduction

This skill acts as a maintenance agent for the my-neovim-pluginlist repository. It streamlines the community-driven curation process by automating the discovery, validation, and documentation of new Neovim plugins. The agent processes lists of raw plugin URLs, performs health and quality checks against GitHub repositories (such as checking for forks, language, and configuration-only status), and ensures high-quality entries are indexed into the appropriate markdown-based category files.

  • Automated GitHub validation: Checks for repository activity, language (English), and ensures the repository is a legitimate plugin rather than a user configuration or learning project.

  • Hierarchical classification: Maps plugins to specific Neovim functionality categories based on section hierarchies defined in the repository.

  • Markdown documentation management: Automatically appends plugin entries (including GitHub metadata shields) to the correct sections of existing .md files.

  • Reason generation: Maintains a .reason.md audit log that records categorization logic and logs exclusions for transparency.

  • Integration support: Handles specialized categorization for complex plugins like fuzzy-finder extensions, completion sources, and LSP-related tools by placing them in their context-specific domains rather than generic sections.

  • Input requirements: Expects a file named .new_plugins.txt containing raw GitHub URLs for new entries.

  • Constraint management: Automatically excludes colorschemes, forks, repositories without READMEs, and non-plugin content based on predefined logic rules.

  • CI/CD Readiness: Designed to run as a non-interactive CI process, requiring no human verification for standard categorization tasks.

  • Categorization hierarchy: Adheres to the specific folder and heading structure of references/SECTION.md to ensure structural integrity across the repository.

Repository Stats

Stars
817
Forks
11
Open Issues
0
Language
Shell
Default Branch
main
Sync Status
Idle
Last Synced
May 3, 2026, 07:10 PM
View on GitHub