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
.mdfiles. -
Reason generation: Maintains a
.reason.mdaudit 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.txtcontaining 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.mdto 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