# Rusty Update

> Consolidated Claude Code sync and parity tracking for RustyClawd. Fetches latest Claude Code features from official sources, compares against the local feature inventory, identifies gaps, and optionally creates GitHub issues. Also supports deep analysis by deminifying the installed Claude Code cli.js.

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

---


# /rusty-update

Consolidated Claude Code sync and parity tracking skill for RustyClawd.

## What This Skill Does

This skill consolidates three previously separate tools into one unified workflow:

1. **Feature Discovery** - Fetches Claude Code's CHANGELOG.md and README.md from GitHub
2. **Gap Analysis** - Compares discovered features against `.claude/data/feature_inventory.yaml`
3. **Reporting** - Summarizes what's new, what's missing, and what's drifted
4. **Issue Creation** (optional) - Creates GitHub issues for gaps via the sync ledger

Additionally supports:
5. **Deep Analysis** - Deminifies installed Claude Code `cli.js` for pattern research

## Modes

### Quick Check (default)
Fetches Claude Code sources and compares against inventory. No side effects.

```
/rusty-update
/rusty-update check
```

### Full Sync (creates GitHub issues)
Runs the Rust SyncMonitor which also creates GitHub issues for gaps.

```
/rusty-update sync
```

Requires: `GITHUB_TOKEN` environment variable.

### Deep Analysis
Deminifies the installed Claude Code cli.js and creates searchable indices.

```
/rusty-update analyze
```

Requires: `prettier` and `js-beautify` (must be installed manually; skill will check and abort with instructions if missing).

### Inventory Update
Interactively update the feature inventory after implementing new features.

```
/rusty-update inventory
```

## Underlying Tools (Consolidated)

| Previous Tool | Location | Status | Merged Into |
|---|---|---|---|
| `claude_code_sync_cli` | `crates/tools/examples/` | Working | `sync` mode |
| `analyze-claude-code.sh` | `scripts/` | Working | `analyze` mode |
| `fetch_claude_features.rs` | `scripts/` | Redundant | `check` mode (superseded) |
| `claude-code-sync.yml` | `.github/workflows/` | Working | Unchanged (CI) |

## Data Files

- **Docs Inventory** (primary): `docs/feature_inventory.yaml` - Most comprehensive, with test evidence
- **Sync Monitor Inventory**: `.claude/data/feature_inventory.yaml` - Used by Rust sync monitor (may lag behind docs version)
- **Sync Ledger**: `.claude/data/sync_ledger.json` - Issue deduplication tracking

**Important**: The `docs/` inventory is the more complete and up-to-date source. The `.claude/data/` version is consumed by the Rust sync monitor. Both should be kept in sync.

## Architecture

```
/rusty-update (skill)
    |
    +-- check: WebFetch CHANGELOG.md + README.md -> compare with inventory -> report
    |
    +-- sync:  cargo run claude_code_sync_cli -> full sync with issue creation
    |
    +-- analyze: scripts/analyze-claude-code.sh -> deminify + index cli.js
    |
    +-- inventory: Interactive inventory update workflow
```

## Execution

When this skill activates, follow this procedure:

### For `check` mode (default):

1. **Fetch** the official Claude Code CHANGELOG.md and README.md:
   - `https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md`
   - `https://raw.githubusercontent.com/anthropics/claude-code/main/README.md`

2. **Read** both local feature inventories:
   - `docs/feature_inventory.yaml` (primary, most comprehensive)
   - `.claude/data/feature_inventory.yaml` (sync monitor source)
   - Flag any drift between them

3. **Compare** features found in the changelog against the inventory:
   - New features not in inventory = **Missing**
   - Features marked partial = **Incomplete**
   - Features that may have changed = **Drift**

4. **Report** findings as a summary table with:
   - New Claude Code features since last check
   - Gaps (missing/incomplete/drift)
   - Recommended actions

### For `sync` mode:

1. Verify `GITHUB_TOKEN` is set in environment. If not, abort with clear error.
2. Run the Rust sync monitor (pass token via environment, not CLI arg if possible):
   ```
   cargo run --package rustyclawd-tools --example claude_code_sync_cli -- \
     --inventory .claude/data/feature_inventory.yaml \
     --ledger .claude/data/sync_ledger.json \
     --token $GITHUB_TOKEN \
     --repo rysweet/RustyClawd
   ```
3. Report created issues

### For `analyze` mode:

1. Check prerequisites: `claude`, `prettier`, `js-beautify` must be installed. Abort with install instructions if missing.
2. Run: `echo "n" | bash scripts/analyze-claude-code.sh` (pipe "n" to skip interactive VS Code prompt)
3. Report location of deminified files and indices

### For `inventory` mode:

1. Read both inventory files: `docs/feature_inventory.yaml` (primary) and `.claude/data/feature_inventory.yaml`
2. Flag any drift between them
3. Ask what features to add/update
4. Write updated inventory to BOTH files to keep them in sync