# List Issues

> List issues in a GitHub repository with filtering options

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

---


# list_issues

List issues in a GitHub repository with filtering options

## Purpose

This skill provides access to the MCP tool `list_issues`. It allows you to list issues in a github repository with filtering options.

## Parameters

The tool accepts the following parameters:

### `owner`
**Required**
- **Type**: `string`
- **Description**: No description provided

### `repo`
**Required**
- **Type**: `string`
- **Description**: No description provided

### `direction`
*Optional*
- **Type**: `string`
- **Description**: No description provided
- **Allowed values**: asc, desc

### `labels`
*Optional*
- **Type**: `array`
- **Description**: No description provided

### `page`
*Optional*
- **Type**: `number`
- **Description**: No description provided

### `per_page`
*Optional*
- **Type**: `number`
- **Description**: No description provided

### `since`
*Optional*
- **Type**: `string`
- **Description**: No description provided

### `sort`
*Optional*
- **Type**: `string`
- **Description**: No description provided
- **Allowed values**: created, updated, comments

### `state`
*Optional*
- **Type**: `string`
- **Description**: No description provided
- **Allowed values**: open, closed, all


## Usage Instructions

To use this tool:

1. **Prepare the parameters** according to the schema above
2. **Invoke the MCP tool** `list_issues` with the prepared parameters
3. **Process the result** returned by the tool

## Example

```json
{
  "owner": "example_value",
  "repo": "example_value",
  "direction": "example_value",
  "labels": {},
  "page": 123,
  "per_page": 123,
  "since": "example_value",
  "sort": "example_value",
  "state": "example_value"
}
```


## Notes

- This skill requires an active MCP connection to the server providing the `list_issues` tool
- Ensure the MCP server is properly configured and running before attempting to use this tool
- Review the parameter requirements carefully to avoid errors