mcpField
S
sweepi

sweepi

github.com/jjenzzTesting & quality34117 installsUpdated 32w ago
Repository

About sweepi

sweepi is an Agent Skill for coordinating code lint checks, intended for agents reviewing changes or preparing commits. It delegates linting to a sub-agent and reports either CLEAN or BLOCKED.

Key features

  1. 01Set scope to changed files or all files
  2. 02Delegate linting to a sub-agent
  3. 03Retry or report blockers
  4. 04Return CLEAN or structured blockers only

Use cases

  1. 01Run lint checks before a commit
  2. 02Check changed files for lint violations
  3. 03Handle a user request for sweepi or linting

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jjenzz/sweepi --skill sweepi

After installing, type/sweepiin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

AGENTS.md
rules/
complexity.md
jsx-bem-compound-naming.md
jsx-compound-part-export-naming.md
jsx-flat-owner-tree.md
jsx-on-handler-verb-suffix.md
jsx-server-action-prop-suffix.md
max-custom-props.md
no-array-props.md
no-boolean-capability-props.md
no-componenttype-props.md
no-custom-kebab-case-props.md
no-element-props.md
no-exported-context-hooks.md
no-external-binding-mutation.md
no-handle-prefix-utils.md
no-handler-return-type.md
no-hook-jsx.md
no-inline-call-expressions.md
no-object-props.md
no-optional-props-without-defaults.md
no-prefixed-prop-bundles.md
no-prop-drilling.md
no-render-helper-functions.md
no-return-object-repetition.md
no-set-prefix-utils.md
no-title-case-props.md
no-useless-hook.md

Details

From the project README

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

Comments

Markdown supported