# kb-refresh-stinger

kb-refresh-stinger refreshes the entire docs folder: splits work into units, runs parallel writer and verifier agents, checks citations and secrets, opens ready PRs with gate reports.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/documentation-tools/skills/kb-refresh-stinger/SKILL.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/kb-refresh-stinger

## What it does

The skill inventories the `library/` folder, divides files into domain units and runs a chain of agents on each: a writer rewrites the doc with `path:line` citations pinned to a specific commit, a verifier independently rechecks every citation (up to three rounds), then come secret and quality gates with automated fixes. The fleet runs as wide as the provider accepts. Agents never touch code: suspected bugs go into a separate log.

The skill is part of the `documentation-tools` package and requires installed `wasp-nest-core` plus `code-audit-tools` for Swarm inventory. Without FFmpeg in `PATH`, the final PDF report will not build. Each PR is created from a branch off the pinned base commit, passes the repo's validation script, and includes the gate report in its body.

At the end, the skill delivers a markdown work report, a PDF version, a master suspect list of code issues the fleet noticed, and a drift report comparing docs to requirements.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install documentation-tools@wasp-nest
```
This installs the whole documentation-tools plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add legioncodeinc/vibe-coding-tools --skill kb-refresh-stinger -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/kb-refresh-stinger/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/kb-refresh-stinger/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add legioncodeinc/vibe-coding-tools --skill kb-refresh-stinger -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/kb-refresh-stinger/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add legioncodeinc/vibe-coding-tools --skill kb-refresh-stinger -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/kb-refresh-stinger/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install legioncodeinc/vibe-coding-tools plugins/documentation-tools/skills/kb-refresh-stinger
```

2. **Manually: put the files in place**
- File: `.github/skills/kb-refresh-stinger/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add legioncodeinc/vibe-coding-tools --skill kb-refresh-stinger -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/legioncodeinc/vibe-coding-tools --path plugins/documentation-tools/skills/kb-refresh-stinger
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/kb-refresh-stinger/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/documentation-tools/skills/kb-refresh-stinger/SKILL.md

## When to use it
- refresh stale documentation in full before an audit or merge wave
- verify every citation in the docs against actual code
- record where docs have drifted without modifying code
- run dozens of agents in parallel for rewriting and verification
- collect a suspect list of code issues the fleet observed

## Example prompts
- Refresh all documentation in `library/` with citations and checks
- Run a full knowledge base refresh with report and suspect list
- Split the docs into units and update them in parallel with the agent fleet

## Similar
- [source-command-ccguide-refresh-docs](https://affpapa.org/en/nevibecode/skills/source-command-ccguide-refresh-docs.md) — skill · ★ 6529 repo stars
- [refresh-docs](https://affpapa.org/en/nevibecode/commands/refresh-docs.md) — command · ★ 6529 repo stars
- [ce-compound-refresh](https://affpapa.org/en/nevibecode/skills/ce-compound-refresh.md) — skill · 3500 installs
- [maintain-verification-skill](https://affpapa.org/en/nevibecode/skills/maintain-verification-skill.md) — skill · 10200 installs
- [citation-validator](https://affpapa.org/en/nevibecode/skills/liangdabiao-citation-validator.md) — skill · 217 installs
- [Lenz Fact-Check](https://affpapa.org/en/nevibecode/mcp/lenz-fact-check.md) — MCP server

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
