# imdone-ls Claude Code Skill

A Claude Code skill for listing and filtering Jira or GitHub issues using the `imdone ls` command.

## Files

- **SKILL.md** - Main skill definition with YAML frontmatter and instructions
- **examples.md** - Comprehensive examples for different use cases
- **README.md** - This file

## Usage

Invoke the skill in Claude Code with:

```
/imdone-ls
```

Or let Claude automatically invoke it when you ask questions like:
- "Show me all issues"
- "List my favorite issues"
- "Show me high priority bugs"
- "What issues are in progress?"
- "List the most recent issues"

## What It Does

The skill helps you:

1. **List issues** in various formats (compact, long, JSON, CSV, YAML)
2. **Filter issues** by favorites, status, priority, labels, time
3. **Sort issues** by modification time, in forward or reverse order
4. **Build custom queries** for Jira (JQL) or GitHub search syntax
5. **Limit results** to show only top N issues
6. **Export data** in different formats for reporting or automation

## Examples

### Basic Listing
```bash
/imdone-ls
# Claude will run: imdone ls
```

### With Filters
Ask: "Show me my 5 most recent favorite issues"
```bash
# Claude will run: imdone ls --fav -t --limit 5
```

### Custom Queries
Ask: "Show me high priority issues in the current sprint"

For Jira:
```bash
# Claude will run: imdone ls -q "project = PROJ AND priority IN ('High', 'Highest') AND sprint in openSprints()"
```

For GitHub:
```bash
# Claude will run: imdone ls -q "label:high-priority milestone:current-sprint is:open"
```

## Provider Support

Works with both:
- **Jira** - Uses JQL (Jira Query Language) for queries
- **GitHub** - Uses GitHub search syntax for queries

Claude automatically detects which provider you're using from `.imdone/config.yml`.

## Query Examples

See [examples.md](examples.md) for comprehensive query examples including:
- Status filtering
- Assignment filtering
- Priority filtering
- Time-based queries
- Label/milestone filtering
- Sprint/epic queries
- Complex combined queries

## Output Formats

- **text** (default) - Human-readable table or compact list
- **json** - Structured JSON for automation
- **yaml** - YAML format for configuration
- **csv** - CSV for spreadsheets and reporting

## Tips

- Use `-l` for detailed table view
- Use `-t` to sort by time (most recent first)
- Use `-r` to reverse any sort
- Use `--fav` to see only favorites
- Use `--verbose` to see the actual query being executed
- Combine flags: `-ltr` = long format, time-sorted, reversed

## Location

This skill is project-specific and stored in:
```
/Users/jessepiascik/projects/imdone-projects/imdone-jira-plugin/.claude/skills/imdone-ls/
```

It will only be available when working on this imdone-jira-plugin project.
