# Sweepi

> Required orchestrater for linting using a dedicated sub-agent. Trigger when asked to run sweepi/linting + fixes, and before proposing commits. Use when this capability is needed.

- Skill: `tomevault-io/sweepi` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/sweepi`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/sweepi/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/sweepi

---


# Sweepi Orchestrator

Parent orchestrates only. Parent does not run Sweepi directly.

## Trigger

- User asks for `sweepi` or linting
- Parent is preparing to propose a commit
- Changed files may violate lint rules

## Flow

`COLLECT_FILES -> LINT -> RESULT`

- `COLLECT_FILES`: determine lint scope (`changed files` or `--all`)
- `LINT`: invoke lint sub-agent
- `RESULT`:
  - `BLOCKED`: retry with clarified scope or escalate to user with blocker details
  - `CLEAN`: report success

## Sub-Agent Invocation Contract

Parent prompt to lint sub-agent MUST include:

`Load and obey role instructions in <SKILL-ROOT-DIR>/AGENTS.md`

And must specify lint scope:

- `sweepi . --file "<path>" ...` for changed files
- `sweepi . --all` when linting everything

Parent MUST NOT load lint instruction files into parent context.

## Guardrails

- Do not suppress rules or disable linting
- Do not make speculative fixes without rule guidance/docs
- Return only: `CLEAN` or `BLOCKED` with structured blockers

---
> Source: [jjenzz/sweepi](https://github.com/jjenzz/sweepi) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-22 -->