# Gh Repo Check

> Internal executor for repository/docs health checks and stack-aware format/lint/test/build command execution.

- Skill: `gustavo-gardusi/gh-repo-check` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gustavo-gardusi/gh-repo-check`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gustavo-gardusi/gh-repo-check/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gustavo-gardusi (https://skillmd.com/u/gustavo-gardusi)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/gustavo-gardusi/gh-repo-check

---


# Repo Check (internal)

Internal executor for the public `@gh-check` boundary.

## Responsibility

- Own runnable terminal checks for docs consistency and project health.
- Detect available toolchain and execute relevant checks.
- Report pass/fail with blockers and skipped steps.

## Command runbook

### 1) Baseline discovery

```bash
git rev-parse --is-inside-work-tree
```

Inspect repository signals before running checks.

### 2) Docs consistency checks

Validate consistency across:
- `README.md`
- `docs/*.md`
- `skills/README.md`

Use read/search tooling to detect drift in:
- public skill list,
- workflow order,
- storage/boundary rules.

### 3) Stack-aware command matrix

Run only applicable commands:

- Node (`package.json`): format/lint/test/build scripts via package manager
- Python (`pyproject.toml`, `requirements*.txt`): formatter/linter/test commands
- Rust (`Cargo.toml`): `cargo fmt`, `cargo clippy`, `cargo test`
- Go (`go.mod`): `go test ./...` and formatting/lint if configured

### 4) Report

Include:
- checks run,
- checks skipped and why,
- failing commands with actionable blockers.

