# Grandcamel Jira Assistant Skills Jira Ops > JIRA Operations Skill - Skill: `tomevault-io/grandcamel-jira-assistant-skills-jira-ops` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/grandcamel-jira-assistant-skills-jira-ops` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/grandcamel-jira-assistant-skills-jira-ops/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/grandcamel-jira-assistant-skills-jira-ops --- # JIRA Operations Skill Cache management, request batching, and operational utilities for JIRA Assistant. ## Risk Levels | Operation | Risk | Notes | |-----------|------|-------| | Discover project | `-` | Read-only analysis | | Cache status | `-` | Read-only | | Cache warm | `-` | Populates local cache | | Cache clear (dry-run) | `-` | Preview only | | Cache clear | `!` | Local cache cleared, will re-fetch | **Risk Legend**: `-` Safe, read-only | `!` Caution, modifiable | `!!` Warning, destructive but recoverable | `!!!` Danger, irreversible ## When to Use This Skill Use this skill when you need to: - **Discover project context**: Auto-discover project metadata, workflows, and usage patterns - **Monitor cache status**: Check cache size, entry counts, and hit rates - **Clear cache data**: Remove stale or sensitive cached data - **Pre-warm cache**: Load commonly accessed data for better performance - **Optimize performance**: Reduce API calls through effective caching - **Troubleshoot slowness**: Diagnose cache-related performance issues ## What This Skill Does **IMPORTANT:** Always use the `jira-as` CLI. Never run Python scripts directly. - **Project Discovery**: Discover project metadata, workflows, and patterns for intelligent defaults - **Cache Status Monitoring**: Display cache statistics (size, entries, hit rates) - **Cache Clearing**: Remove cache entries by category, pattern, or all at once - **Cache Warming**: Pre-load project metadata and field definitions - **Request Batching**: Parallel request execution for bulk operations (programmatic API) ## Quick Start ```bash # Discover project context (saves to skill directory by default) jira-as ops discover-project PROJ # Check cache status jira-as ops cache-status # Clear all cache jira-as ops cache-clear --force # Warm cache with all metadata jira-as ops cache-warm --all ``` ## Common Tasks (30-Second Solutions) ### Check cache status ```bash # Basic status jira-as ops cache-status # Output as JSON jira-as ops cache-status --json # Verbose output (-v is short for --verbose) jira-as ops cache-status -v jira-as ops cache-status --verbose ``` ### Warm the cache ```bash # Cache project list jira-as ops cache-warm --projects # Cache field definitions jira-as ops cache-warm --fields # Cache assignable users (requires project context) jira-as ops cache-warm --users # Cache all available metadata with verbose output jira-as ops cache-warm --all --verbose # Output as JSON jira-as ops cache-warm --all --json ``` ### Clear cache ```bash # Clear all cache (with confirmation) jira-as ops cache-clear # Clear all cache (skip confirmation, -f is short for --force) jira-as ops cache-clear -f jira-as ops cache-clear --force # Clear only issue cache (-c is short for --category) # Categories: issue, project, user, field, search, default jira-as ops cache-clear -c issue -f jira-as ops cache-clear --category issue --force # Preview what would be cleared jira-as ops cache-clear --dry-run # Clear keys matching pattern jira-as ops cache-clear --pattern "PROJ-*" -c issue -f # Clear specific cache key (requires --category) jira-as ops cache-clear --key "PROJ-123" -c issue -f # Output as JSON jira-as ops cache-clear -f --json ``` ### Discover project context ```bash # Discover and output project context (text format) jira-as ops discover-project PROJ # Output as JSON (-o is short for --output) jira-as ops discover-project PROJ -o json jira-as ops discover-project PROJ --output json # Verbose output with detailed analysis (-v is short for --verbose) jira-as ops discover-project PROJ -v # Custom sample size and period (-s, -d are short forms) jira-as ops discover-project PROJ -s 200 -d 60 jira-as ops discover-project PROJ --sample-size 200 --days 60 ``` See [Commands Guide](docs/COMMANDS.md) for complete documentation. ## Available Commands All commands support `--help` for full documentation. | Command | Description | |---------|-------------| | `jira-as ops discover-project` | Discover project metadata, workflows, and patterns | | `jira-as ops cache-status` | Display cache statistics (size, entries, hit rate) | | `jira-as ops cache-clear` | Clear cache entries (all, by category, or by pattern) | | `jira-as ops cache-warm` | Pre-warm cache with commonly accessed data | ## Exit Codes | Code | Meaning | |------|---------| | 0 | Success | | 1 | General error | | 2 | Configuration error | | 3 | Cache database error | | 4 | Network error | ## Configuration Cache is stored in `~/.jira-skills/cache/` with configurable TTL per category. See [Configuration Guide](docs/CONFIG.md) for details. ## Shared Libraries This skill uses shared infrastructure from `jira-as`: | Library | Description | |---------|-------------| | `cache.py` | SQLite-based caching with TTL and LRU eviction | | `request_batcher.py` | Parallel request batching for bulk operations | See [API Reference](docs/API_REFERENCE.md) for programmatic usage. ## Documentation - [Quick Start Guide](docs/QUICK_START.md) - Get started in 5 minutes - [Scripts Guide](docs/SCRIPTS.md) - Detailed script documentation - [API Reference](docs/API_REFERENCE.md) - Programmatic cache and batcher APIs - [Configuration](docs/CONFIG.md) - TTL settings - [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and solutions - [Security](docs/SECURITY.md) - Cache security considerations - [Best Practices](docs/best-practices/INDEX.md) - Optimization patterns --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/grandcamel) — claim your Tome and manage your conversions.