observal-advanced
Advanced Observal operations including session reconciliation, CLI upgrades and downgrades, complete uninstallation, and local fallback mode for offline use. Use when the user wants to reconcile sessions, upgrade or downgrade the CLI, uninstall Observal, or write agent configs locally when the server is unreachable.
npx skills add Observal/Observal --skill observal-advanced --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Observal Advanced Operations ## Procedure: Reconcile Sessions Push local session JSONL to server for full trace context. Normally automatic via hooks. Manual recovery for all detected harnesses: ```bash observal reconcile ``` Target one harness or shorten the discovery window when needed: ```bash observal reconcile --harness claude-code --since 24 ``` --- ## Procedure: Self-Manage CLI ```bash observal self status observal self upgrade --force observal self upgrade --version 2.5.0 --force observal self downgrade --list observal self downgrade --version 2.4.0 --force observal self rollback ``` Use `--force` when running upgrades or downgrades from an agent so the command is non-interactive. --- ## Procedure: Uninstall Completely removes Observal. **Destructive and irreversible.** ```bash observal self uninstall ``` Requires typing `confirm` (not `--yes`). Selective flags: - `--keep-config`: preserve `~/.observal/` - `--keep-cli`: keep the CLI binary - `--keep-repo`: keep the cloned repo - `--repo-dir PATH`: specify repo location --- ## Procedure: Local Fallback Mode Use **only** when a command exits with `Connection failed` or `Not configured`. | harness | User-scope path | Project
- Procedure: Reconcile Sessions
- Procedure: Self-Manage CLI
- Procedure: Uninstall
- Procedure: Local Fallback Mode
- Output Contract
observal reconcile observal reconcile --harness claude-code --since 24 observal self status observal self upgrade --force observal self upgrade --version 2.5.0 --force observal self downgrade --list observal self downgrade --version 2.4.0 --force observal self rollback observal self uninstall
What does the observal-advanced skill do?
Advanced Observal operations including session reconciliation, CLI upgrades and downgrades, complete uninstallation, and local fallback mode for offline use. Use when the user wants to reconcile sessions, upgrade or downgrade the CLI, uninstall Observal, or write agent configs locally when the server is unreachable.
How do I install it?
Run `npx skills add Observal/Observal --skill observal-advanced --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From Observal/Observal, a repository with 2,254 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.