# Repo Health Check

> Use when auditing a repo before changes to find the smallest safe PR, quality risks, stale docs, missing tests, ignored-file gaps, or agent setup issues. Best first skill for unfamiliar codebases.

- **Type:** Skill
- **Install:** `agentstack add skill-dominiktobureto-awesome-grok-build-repo-health-check`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [DominikTobureto](https://agentstack.voostack.com/s/dominiktobureto)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [DominikTobureto](https://github.com/DominikTobureto)
- **Source:** https://github.com/DominikTobureto/awesome-grok-build/tree/main/.grok/skills/repo-health-check

## Install

```sh
agentstack add skill-dominiktobureto-awesome-grok-build-repo-health-check
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Repo Health Check

Find the smallest useful change with the best risk/reward ratio.

## Grok Build Mode

- Start in Plan Mode for unfamiliar repos or when changes may touch multiple subsystems.
- Use subagents for parallel read-only discovery when the repo is medium/large:
  - `structure`: map stack, entry points, and package managers.
  - `quality`: find test, lint, typecheck, CI, and coverage signals.
  - `docs`: compare README commands with real config.
  - `safety`: inspect `.gitignore`, `.grokignore`, secrets patterns, hooks, and AGENTS.md.
- Arena-style comparison: if Grok Build exposes Arena Mode, run candidate-first-PR proposals against 3-5 agents and rank by verification confidence. Otherwise simulate by asking subagents for independent candidates.

## Workflow

1. Read repo instructions: `AGENTS.md`, `README.md`, package/config files, CI files.
2. Identify project type, main runtime, package manager, and quality gates.
3. Look for high-signal risks:
   - stale or missing setup docs;
   - absent tests around core behavior;
   - failing lint/type/test commands;
   - generated output committed unexpectedly;
   - missing `.grokignore` or obvious secret exposure;
   - dependency and lockfile mismatch;
   - unsafe hooks or unclear agent instructions.
4. Produce 3 candidate PRs ranked by impact, size, blast radius, and verification confidence.
5. Ask for human approval before edits.
6. Implement only the chosen candidate.
7. Run the smallest relevant lint/test/type/docs check.
8. Summarize changed files and residual risks.

## Git Discipline

- Never commit generated junk, secrets, or local agent state.
- Keep the first PR tiny.
- If tests fail for unrelated reasons, capture the exact failure and avoid broad cleanup.

## Example Prompts

```text
Use repo-health-check. Inspect this repo and propose the smallest safe PR we should ship first. Do not edit yet.
```

```text
Run repo-health-check with subagents for structure, tests, docs, and safety. Rank the top 3 fixes and wait for my approval.
```

## Output

Start with:

```text
Bottom line: 
```

Then provide:

- repo type and stack;
- discovered commands;
- top risks;
- 3 candidate PRs;
- recommended first PR;
- verification plan;
- whether edits require Plan Mode approval.

## Guardrails

- Do not invent test commands. Read package/config files first.
- Do not edit generated files unless the repo intentionally tracks them.
- Do not upgrade dependencies unless explicitly requested.
- If no safe command is available, explain what could not be verified.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [DominikTobureto](https://github.com/DominikTobureto)
- **Source:** [DominikTobureto/awesome-grok-build](https://github.com/DominikTobureto/awesome-grok-build)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-dominiktobureto-awesome-grok-build-repo-health-check
- Seller: https://agentstack.voostack.com/s/dominiktobureto
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.