auto-gitignore-skill

A global Claude Code skill that automatically generates or updates .gitignore files based on detected project type.

Available on npm:

• @blurtopian/auto-gitignore-skill
• @aigentskills/auto-gitignore-skill

Features

• Proactive Detection: Automatically detects when a project needs a .gitignore file
• Multi-language Support: Node.js, Python, Rust, Go, Java, Ruby, Swift, .NET, Aleo/Leo
• Smart Merging: Updates existing .gitignore without losing custom patterns
• Hybrid Templates: Uses gitignore.io API with local fallback for offline use
• Always Includes: Secrets, build folders, test output, OS/editor files

Installation

Method 1: CLI Installer (Recommended)

npx @blurtopian/auto-gitignore-skill install
# or
npx @aigentskills/auto-gitignore-skill install

Method 2: Manual Installation

npm pack @blurtopian/auto-gitignore-skill
tar -xzf blurtopian-auto-gitignore-skill-*.tgz
mkdir -p ~/.claude/plugins/repos
cp -r package/skill ~/.claude/plugins/repos/auto-gitignore

Usage

Automatic (SessionStart Hook)

When you start Claude Code in a project directory, the skill automatically checks if a .gitignore is needed and suggests creating one.

Slash Command

/gitignore                    # Auto-detect project type and create .gitignore
/gitignore --force            # Overwrite existing .gitignore
/gitignore --types node,python  # Specify types manually

Natural Language

Just ask Claude:

• "Create a gitignore for this project"
• "Update my gitignore"
• "Add Python patterns to gitignore"

Supported Project Types

Type	Detection Files
Node.js	package.json, node_modules/
Python	requirements.txt, pyproject.toml, setup.py, Pipfile
Rust	Cargo.toml
Go	go.mod
Java	pom.xml, build.gradle
Ruby	Gemfile
Swift	Package.swift, *.xcodeproj
.NET	*.csproj, *.sln
Aleo/Leo	program.json, *.leo

Always-Included Patterns

Regardless of project type, these are always included:

• Secrets: .env, .env.*, *.pem, *.key, credentials.json
• Build: dist/, build/, out/, target/, bin/, obj/
• Test Output: coverage/, .nyc_output/, test-results/
• OS/Editor: .DS_Store, .idea/, .vscode/, *.swp

Uninstallation

rm -rf ~/.claude/plugins/repos/auto-gitignore
# or
auto-gitignore-skill uninstall

License

MIT