# github-repo-health-wasp-drone

github-repo-health-wasp-drone audits GitHub repository hygiene across eight structural areas. Helps teams find gaps in branch protection, CI configurations, and metadata without modifying code.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 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/wasp-nest-core/agents/github-repo-health-wasp-drone.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/github-repo-health-wasp-drone

## What it does

This subagent inspects GitHub repository structure across eight distinct dimensions: rulesets and branch protection, adherence to Conventional Commits, `CODEOWNERS` coverage, CI workflow density, documentation presence, `.gitignore` completeness, pull request and issue templates, and core project settings. Findings are scored and sorted by impact divided by effort.

Operation is strictly read-only. The drone never modifies configuration files, branch guards, or repository options. Depending on the environment, it uses local clone data, GitHub REST API tokens, or the `gh` command-line tool. Without API credentials or a logged-in CLI session on private projects, remote settings checks produce coverage gaps.

Specialized tasks are routed elsewhere. Complex CI pipeline reorganizations pass to `devops-wasp-drone`, leaked credentials and vulnerabilities route to `security-wasp-drone`, and structural rewrite work for documentation goes to `readme-writing-wasp-drone`.

## Requirements
- Works with: GitHub

## 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 wasp-nest-core@wasp-nest
```

2. **Manually: put the files in place**
- File: `.claude/agents/github-repo-health-wasp-drone.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/github-repo-health-wasp-drone.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/github-repo-health-wasp-drone.md` — Cursor also reads .claude/agents/

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/wasp-nest-core/agents/github-repo-health-wasp-drone.md

## When to use it
- audit GitHub branch rulesets and merge settings
- evaluate commit histories for Conventional Commits adherence
- detect missing file patterns in CODEOWNERS and .gitignore
- generate prioritized hygiene checklists based on effort and impact

## Example prompts
- audit this repo
- check branch protection and repository settings
- are our CI checks configured correctly

## Similar
- [repo-standardizer](https://affpapa.org/en/nevibecode/skills/repo-standardizer.md) — skill · 33 installs
- [git-workflow](https://affpapa.org/en/nevibecode/skills/devops-skills-git-workflow.md) — skill · 404 installs
- [github-pr](https://affpapa.org/en/nevibecode/skills/github-pr.md) — skill · 205 installs
- [devkit.github.create-pr](https://affpapa.org/en/nevibecode/commands/devkitgithubcreate-pr.md) — command · ★ 372 repo stars
- [github-workflow](https://affpapa.org/en/nevibecode/agents/github-workflow.md) — subagent · ★ 6091 repo stars
- [github-workflow-automation](https://affpapa.org/en/nevibecode/skills/sickn33-github-workflow-automation.md) — skill · 1500 installs

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
