# Gitignore Sync

> Gitignore Sync

- Skill: `javimosch/gitignore-sync` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/gitignore-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/gitignore-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/gitignore-sync

---


# Gitignore Sync

Generate high-confidence `.gitignore` rules from real repo signals and gitignore.io, then update safely via a managed block so manual rules stay untouched.

## Execution Rule

Use `scripts/update_gitignore.py` as the only execution path.
Do not fetch from the API directly in ad-hoc commands.
Do not manually compose or rewrite `.gitignore` when this skill is selected.

## Workflow

1. Infer requested templates from the user prompt.
2. Detect likely templates from repository files and folders.
3. Run `scripts/update_gitignore.py` with `--prompt-text` and/or `--services`.
4. Let the script fetch combined template rules from `https://www.toptal.com/developers/gitignore/api/<templates>`.
5. Let the script write or update a managed block in `.gitignore`.
6. Preserve non-managed user sections in `.gitignore`.

## Run

From the target repository root, run:

```bash
python3 <skill-path>/scripts/update_gitignore.py \
  --prompt-text "create .gitignore for flutter firebase vscode" \
  --repo .
```

Use explicit templates when the user names exact services:

```bash
python3 <skill-path>/scripts/update_gitignore.py \
  --services flutter,firebase,visualstudiocode \
  --repo .
```

## Notes

- Prefer passing both `--prompt-text` and `--services` when available.
- Keep manual custom rules outside the managed block markers.
- Re-run safely; the script replaces only the managed block.
- Use `--rules-file` for offline/local testing when network access is blocked.

