From cass
This skill should be used when the user asks to "fix cass", "rebuild index", "cass doctor", "repair sessions", "index status", "reindex", "cass not working", "search is broken", "stale index", "rebuild analytics", "validate data", "manage models", "semantic search setup", "configure remote sources", "sync sources", or needs to diagnose, repair, or maintain their CASS installation, index, analytics data, semantic models, or remote sources.
How this skill is triggered — by the user, by Claude, or both
Slash command
/cass:session-maintenanceThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Diagnose, repair, and maintain the CASS installation including the search index,
Diagnose, repair, and maintain the CASS installation including the search index, analytics rollup tables, semantic search models, and remote sources.
Fast pre-flight check (<50ms):
cass health --json
Exit 0 = healthy, 1 = unhealthy. Use this before any search operation.
cass status --json
Returns: index freshness, database stats, pending sessions, recommended action.
cass diag --json --verbose
Returns: version, platform, database size, index size, connector status, paths.
# Incremental update (new sessions only)
cass index --json
# Full rebuild from scratch
cass index --full --json
# Build with semantic embeddings
cass index --full --semantic --json
# Build HNSW index for fast approximate search
cass index --full --semantic --build-hnsw --json
# Watch mode (re-index on changes)
cass index --watch --json
cass health returns unhealthycass status shows stale: truecass analytics status --json
Look at:
data.coverage.api_token_coverage_pct — should be > 0% for meaningful token analyticsdata.drift.signals — any drift indicates inconsistencydata.recommended_action — follow this# Check for issues
cass analytics validate --json
# Auto-fix safe issues (Track A rollups only)
cass analytics validate --fix --json
# Rebuild when rollups are stale or corrupt
cass analytics rebuild --json
# Force rebuild even if rollups appear fresh
cass analytics rebuild --force --json
When analytics data is wrong:
# 1. Validate to identify issues
cass analytics validate --json
# 2. If errors found, try auto-fix first
cass analytics validate --fix --json
# 3. If auto-fix insufficient, force rebuild
cass analytics rebuild --force --json
# 4. Re-validate to confirm
cass analytics validate --json
Automated diagnosis and repair:
# Diagnose issues (safe, read-only)
cass doctor
# Apply automatic repairs (rebuilds derived data, preserves sources)
cass doctor --fix
Doctor is safe by default — it never deletes user session data. The --fix flag
only rebuilds derived data (index, rollups).
cass models status --json
Semantic search requires embedding models. After downloading a model:
# Build semantic index
cass index --semantic --json
# Build HNSW for fast approximate search
cass index --semantic --build-hnsw --json
For faster repeated semantic queries, use the daemon:
# Start the daemon (Unix only)
cass daemon
# Searches will auto-use daemon when available
cass search "concept" --mode semantic --daemon --json
Interactive wizard for configuring multi-machine search:
# Interactive setup (recommended)
cass sources setup
# Specific hosts
cass sources setup --hosts css,csd
# Preview without changes
cass sources setup --dry-run
# Non-interactive (for scripting)
cass sources setup --non-interactive --hosts css,csd
# List configured sources
cass sources list
# Sync data from all sources
cass sources sync
# Discover available hosts
cass sources discover
# Add a source manually
cass sources add user@hostname
cass health --json — check if healthycass stats --json — check conversation/message countscass index --full --jsoncass analytics status --json — check coverageapi_token_coverage_pct is 0: API tokens not available for your agents (content estimates still work)cass analytics rebuild --json# Check how stale
cass status --json
# Refresh
cass index --json
# Or set up watch mode for automatic updates
cass index --watch
# If retryable=true: transient lock, retry after 1s
# If retryable=false: schema issue
cass doctor --fix
cass index --full --json
| Code | Meaning | Action |
|---|---|---|
| 0 | Success | - |
| 2 | Usage error | Fix command flags |
| 3 | Missing database | Run cass index --full |
| 9 | Database error | Run cass doctor --fix |
cass health --json as a pre-flight check before search operations.cass doctor --fix as the first response to any CASS issue.cass analytics rebuild --json.cass index --watch for always-fresh index during active development.cass sources setup for multi-machine search — it handles SSH config discovery automatically.npx claudepluginhub asragab/asragab-claude-marketplace --plugin cassProvides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.