# navid-workflow

Portable npm-first installer and verifier for the nAvid skill across Codex,
Antigravity IDE and Antigravity CLI.

```powershell
# Codex (default)
npx navid-workflow install
npx navid-workflow doctor
npx navid-workflow verify
npx navid-workflow template
npx --package navid-workflow navid-template

# Antigravity IDE
npx navid-workflow install --runtime antigravity
npx navid-workflow doctor --runtime antigravity
npx navid-workflow verify --runtime antigravity

# Antigravity CLI
npx navid-workflow install --runtime antigravity-cli
npx navid-workflow doctor --runtime antigravity-cli
npx navid-workflow verify --runtime antigravity-cli
```

Installation is explicit. Installing this npm package alone does not modify a
runtime skill directory. `install` writes only the bundled `navid` skill to
the chosen runtime target; it does not touch video projects, run state,
secrets or voice provider configuration.

## Runtime Targets

| Runtime | Default skill target |
| --- | --- |
| `codex` | `~/.codex/skills/navid` |
| `antigravity` | `~/.gemini/antigravity/skills/navid` |
| `antigravity-cli` | `~/.gemini/config/skills/navid` |

Use `--target <skill-path>` to override a runtime path explicitly. The target
must still end in `navid`, and `--force` replaces only that chosen skill
directory after safety checks.

Some Antigravity installations link the IDE skills directory to the CLI
configuration directory. When the two default targets resolve to the same
physical location, install once with either Antigravity runtime preset and use
`doctor`/`verify` for both; do not run concurrent forced installs against the
shared target.

`navid` is the skill identity and `nAvid` is its display brand. The npm
package identifier is `navid-workflow` because `navid` is already occupied in
the public npm registry. Public publication is not performed automatically.

## Template Workflow Shortcut

`/navid-template` is the Codex/agent intent for reusable template authoring.
For terminal checks, use `npx navid-workflow template` or
`npx --package navid-workflow navid-template`. The standalone npm shim
`navid-template` may also be installed or invoked with `npx navid-template`
when published.

## Distributed Brand And Assets

The included approved templates deliberately carry the public channel identity
`AI News | 247 (nA)`, handle `@ainew247na` and its authorized avatar. The
`local-voice-lab` set provides short, standard and extended product-explainer
sequences designed around readable official screenshots and source proof.
It includes Inter, Space Grotesk and Space Mono fonts under SIL OFL notices in
`third-party/fonts/`. No SFX, narration, rendered media, credentials or voice
model files are included.

The portable demo HTML currently references GSAP from jsDelivr for preview
animation. Rendering that included demo therefore requires network access to
the CDN; the installed workflow and its validators remain local.

## Upgrade And Removal Boundary

Running `install --force` replaces only the selected `skills/navid` directory
after safety checks. It never removes video projects, voice provider
configuration or media output. To remove this workflow later, remove only the
installed `skills/navid` directory for the intended runtime; keep project and
configuration directories separate from the skill target.