# Gitnexus Refresh On Stale

> Refresh GitNexus indexing and regenerate local GitNexus skills when repository status is stale. Use when `npx gitnexus status` reports stale/outdated index state, or when you need to sync newly generated `.claude/skills/gitnexus` into `.agents/skills/gitnexus` with overwrite behavior. Use when this capability is needed.

- Skill: `tomevault-io/gitnexus-refresh-on-stale` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/gitnexus-refresh-on-stale`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/gitnexus-refresh-on-stale/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/gitnexus-refresh-on-stale

---


# GitNexus Refresh On Stale

Run this skill from the repository root.

## Workflow

1. Check index status.
```bash
npx gitnexus status
```

2. If status contains `stale` (case-insensitive), run:
```bash
npx gitnexus analyze
```

3. If `.claude/skills/gitnexus` exists after analyze, replace `.agents/skills/gitnexus` with it.
- Delete existing `.agents/skills/gitnexus` when present.
- Move `.claude/skills/gitnexus` to `.agents/skills/gitnexus`.

4. If status is not stale, do not run analyze.

## Script

Use the bundled script for deterministic behavior:
```bash
bash .agents/skills/gitnexus-refresh-on-stale/scripts/refresh_gitnexus_skills.sh
```

The script performs all steps above and prints what it changed.

---
> Source: [ML4ITS/TimeVQVAE](https://github.com/ML4ITS/TimeVQVAE) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-22 -->

