| name | gitignore |
| description | Create or update a project's .gitignore file with sensible defaults for macOS and VS Code, then extend it for detected stacks (for example Node, Python, Go, Rust, Java, Terraform). Use when the user asks to generate, fix, or standardize .gitignore. |
Gitignore
Create or update .gitignore at the target repository root.
Workflow
- Detect stack markers from files in the repo:
- Node:
package.json, pnpm-lock.yaml, yarn.lock
- Python:
pyproject.toml, requirements.txt, poetry.lock
- Go:
go.mod
- Rust:
Cargo.toml
- Java/Kotlin:
pom.xml, build.gradle, build.gradle.kts
- Terraform:
*.tf, .terraform.lock.hcl
- Start from
assets/gitignore.macos-vscode.template.
- Append only relevant stack-specific patterns.
- If
.gitignore already exists:
- Keep user/custom entries.
- Add missing standard patterns.
- Avoid duplicates.
- Never add rules that ignore source code broadly (for example
src/, *.ts, *.py).
Baseline Template
Use assets/gitignore.macos-vscode.template as the base for every generated file.
Stack Add-ons
Add only when relevant:
- Node:
.npm/, .pnpm-store/, .yarn/, .next/, .nuxt/
- Python:
.mypy_cache/, .ruff_cache/, .tox/, .nox/, .ipynb_checkpoints/
- Go:
*.test, coverage.out
- Rust:
target/ (keep Cargo.lock unless user explicitly wants to ignore it)
- Java/Kotlin:
.gradle/, out/, target/
- Terraform:
.terraform/, *.tfstate, *.tfstate.*, crash.log
Output Rules
- Write the final file as
.gitignore in repo root.
- Keep sections grouped with short comments.
- Keep output idempotent so re-running does not introduce churn.
Learning Loop
When using this skill, capture durable, reusable, public-safe learnings back
into this skill's local source materials before completion when the current task
contract allows source edits. Update the narrowest appropriate surface:
SKILL.md for runtime rules, references/ for detailed guidance, assets/
for reusable templates, scripts/ for deterministic helpers, and README or
changelog entries for human-facing or release-note updates.
If the current task is explicitly read-only/report-only, or source writes are
outside this skill's task contract, do not edit skill sources; report the
skipped source update instead.
Do not capture secrets, private URLs, customer data, raw logs, one-off local
state, or unverified/vendor-specific claims. If a useful learning is not safe,
not evidence-backed, or outside this skill's scope, report that it was skipped.
