agentleFS
jasonmichaelbell78-creatorjasonmichaelbell78-creator/sonash-v0/.claude/skills/quick-fix/SKILL.md

quick-fix

Skill2 starsChanged 9 months agoApache-2.0View on GitHub

Auto-suggest fixes for common pre-commit and pattern compliance issues. Or with specific error context: This skill can be suggested by hooks when failures occur: When pre-commit fails, a hook could: When pattern compliance fails:

We split this skill into the rules it gives an agent

7 rules. 0 are common, 7 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 6 edited versions we read keep these.

  • 7

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When the task doesn't match this skill's scope -- check related skills

    line 13
  2. Distinctive:

    When a more specialized skill exists for the specific task

    line 14
  3. Distinctive:

    When pre-commit hook fails with lint errors

    line 18
  4. Distinctive:

    When pattern compliance check fails

    line 19
  5. Distinctive:

    When TypeScript type errors occur

    line 20
  6. Distinctive:

    When pre-commit fails, a hook could:

    line 86
  7. Distinctive:

    When pattern compliance fails:

    line 94

“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

quick-fix Skill

Auto-suggest fixes for common pre-commit and pattern compliance issues.

When NOT to Use

  • When the task doesn't match this skill's scope -- check related skills
  • When a more specialized skill exists for the specific task

When to Use

  • When pre-commit hook fails with lint errors
  • When pattern compliance check fails
  • When TypeScript type errors occur
  • For quick resolution of common blocking issues

What It Does

  1. Parse Error Output
    • Reads the failed check output
    • Categorizes errors by type and severity
    • Identifies auto-fixable vs manual issues
  2. Generate Fix Suggestions
    • ESLint: Suggests npm run lint -- --fix for auto-fixable issues
    • Prettier: Runs lint-staged to auto-format
    • Pattern compliance: Shows specific line changes needed
    • TypeScript: Suggests type annotations or fixes
  3. Apply Auto-Fixes
    • Can run npm run lint -- --fix automatically
    • Stages fixed files for commit
    • Re-runs checks to verify

Usage

/quick-fix

Or with specific error context:

/quick-fix [paste error output]

Common Fix Patterns

ESLint Errors

ErrorAuto-FixCommand
Missing semicolonsYesnpm run lint -- --fix
Unused importsYesnpm run lint -- --fix
Quote styleYesnpm run lint -- --fix
Complex functionsNoManual refactor needed

Pattern Compliance

PatternIssueFix
Direct FirestoreUse repositoryWrap in repository method
Console.logUse loggerReplace with logger.debug()
Hardcoded pathsUse configMove to config file

TypeScript

ErrorFix
Missing typeAdd explicit type annotation
Any usageReplace with specific type
Null checkAdd optional chaining or null check

Hook Integration

This skill can be suggested by hooks when failures occur:

Pre-commit Failure Hook (proposed)

When pre-commit fails, a hook could:

  1. Capture the error output
  2. Suggest /quick-fix with context
  3. Offer auto-fix for known patterns

Pattern Check Failure

When pattern compliance fails:

  1. Show specific file and line numbers
  2. Suggest code changes inline
  3. Offer to apply fix

Output Format

/quick-fix Results
==================

Found 3 issues:

1. ESLint: Unused import (AUTO-FIXABLE)
   File: src/components/Button.tsx:5
   Fix: Remove `import { useState } from 'react'`
   Command: npm run lint -- --fix

2. Pattern: Direct Firestore access (MANUAL)
   File: src/services/user.ts:42
   Issue: `db.collection('users')` should use repository
   Fix: Use `userRepository.find()` instead

3. TypeScript: Missing return type (AUTO-FIXABLE)
   File: src/utils/format.ts:10
   Fix: Add `: string` return type

Auto-fix available for 2 issues.
Run: npm run lint -- --fix && npx tsc --noEmit

Apply auto-fixes? [Y/n]

Related

  • Pre-commit hook - Runs lint, patterns, tests
  • scripts/check-pattern-compliance.js - Pattern checker
  • eslint.config.mjs - ESLint configuration

Version History

VersionDateDescription
1.02026-02-25Initial implementation

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.