It adds new plugin entries to markdown files after validating GitHub repositories and documenting categorization rationale.
Install
mkdir -p .claude/skills/add && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/7964" && unzip -o skill.zip -d .claude/skills/add && rm skill.zipInstalls to .claude/skills/add
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Categorize new Neovim plugins and insert them into the correct markdown category filesKey capabilities
- →Categorize new Neovim plugins
- →Insert plugins into markdown category files
- →Validate plugin suitability via GitHub
- →Generate .reason.md summary files
How it works
The skill reads new plugin lists, validates them against specific criteria, and appends them to the appropriate section in categorized markdown files.
Inputs & outputs
When to use add
- →Add new plugins to documentation
- →Categorize Neovim plugins
- →Update plugin category lists
About this skill
Update each repo's plugin in the right markdown section, then create .reason.md summarizing why each category was chosen.
Tasks
- Get a list of new plugins to add. Run
cat .new_plugins.txt. - Read
references/PLACEMENT_RULES.mdand apply any matching placement rules. - Examine each plugin and their assigned categories.
3.1. Visit the corresponding repository on GitHub.
3.2. If any of the following items apply, remove the added plugins from the list. In the
.reason.mdtable, set the Category column to-and write the exclusion reason in the Reason column.- The plugin is a fork of another repository.
- It is a new colorscheme plugin.
- The repository is not a Neovim plugin: standalone CLI/GUI tools, terminal apps, or libraries whose primary use is outside Neovim, even if the README mentions Neovim support or integration.
- The plugin is written primarily in Vim script, or supports both Vim and Neovim (dual-compatible). This list is for Neovim-specific plugins only. Check the repository language stats and README statements such as "works with Vim 8/9".
- The repository has no README.
- The README is written in a language other than English.
- The repository is a Neovim configuration rather than a plugin.
- The repository is a sample plugin created solely for learning purposes.
- For each plugin, confirm and update if the category is appropriate.
4.1. From the README or other files, infer which Neovim-plugin category the repository belongs to.
4.2. Prefer the plugin's domain or user workflow over implementation surface such as picker UI, completion source, or integration library.
4.3. In
references/SECTION.md, consult the table of contents and locate the markdown file that contains that category. 4.4. Open that markdown file and insert the added plugin at the appropriate position.- ALWAYS append new plugins at the BOTTOM of the section (or subsection). NEVER insert them at the top or near the top. This is mandatory: the last existing plugin entry in the section is the anchor, and the new entry goes immediately after it.
- If no suitable section exists, create one first and then add the plugin.
- If there are subsections, review them and add the plugin to the most appropriate subsection whenever possible — still appending at the bottom of that subsection.
- If there are related plugins, list them directly below the relevant plugin.
- Update the table with correct categories and provide clear reasons.
- Please write the selection reasons in following simple markdown table.
- The format is a Markdown table with the following order: |URL|Category|Reason|.
- The Category column must use slash-delimited format reflecting the full section hierarchy:
filename / Section / Sub-section / ...(e.g.,lsp.md / LSP / Diagnostics,editing.md / Editing / Indent / Auto-indent). Include as many levels as the actual heading hierarchy requires. If there is no sub-section, omit it (e.g.,git-github.md / Git). - Sort the table rows by the Category column so that plugins in the same category are grouped together. Do not omit any plugins from the table, including those excluded in step 3.2.
- Save it as .reason.md
Badge Format
Use this format for plugin entries:
- [author/plugin-name](https://github.com/author/plugin-name)   
IMPORTANT
- Do not ask for confirmation. This task is running on CI.
- New plugins MUST be appended at the bottom of the chosen section/subsection — never at the top. If you find yourself inserting near the top of a section, stop and move the entry to the end.
- If you cannot specify a category, keep it as is.
- Keep categorization rules in
references/PLACEMENT_RULES.mdwhen they are specific enough to reuse.
Input Repositories
- .new_plugins.txt
Output
- UPDATE: [a-z]*.md
- WROTE: .reason.md
Please make the necessary edits to improve categorization accuracy.
When not to use it
- →When the plugin is a fork of another repository
- →When the repository is a Neovim configuration rather than a plugin
- →When the README is not in English
Limitations
- →Cannot categorize plugins that do not fit existing sections
- →Requires plugins to have an English README
How it compares
It automates the categorization and insertion process according to strict placement rules instead of manual documentation updates.
Compared to similar skills
add side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| add (this skill) | 0 | 2mo | No flags | Beginner |
| word | 26 | 9mo | Review | Beginner |
| youtube-clipper | 11 | 6mo | Review | Intermediate |
| daily | 1 | 5mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by yutkat
View all by yutkat →You might also like
word
Fergana-Labs
Create, read, edit, and manipulate Microsoft Word documents (.docx files). Use when users ask to work with Word files, create documents, read .docx files, or format text documents.
youtube-clipper
op7418
YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。 使用场景:当用户需要剪辑 YouTube 视频、生成短视频片段、制作双语字幕版本时。 关键词:视频剪辑、YouTube、字幕翻译、双语字幕、视频下载、clip video
daily
ballred
Create daily notes and manage morning, midday, and evening routines. Structure daily planning, task review, and end-of-day reflection. Use for daily productivity routines or when asked to create today's note.
office-docs
Xxiii8322766509
Extract text and tables from .docx and .xlsx using local scripts (no external deps).
feature-pipeline
notedit
Execute implementation tasks from design documents using markdown checkboxes. Use when (1) implementing features from feature-analyzer output, (2) resuming interrupted work, (3) batch executing tasks. Triggers on 'start implementation', 'run tasks', 'resume'.
douyin-video
yzfly
抖音无水印视频下载和文案提取工具. 从抖音分享链接获取无水印视频下载链接, 下载视频, 提取视频中的语音文案并自动保存到文件. 适用场景包括获取抖音视频信息, 下载无水印视频, 批量提取视频文案. 当用户需要处理抖音视频链接或提取视频内容时触发.