project-view-status

Original：🇨🇳 Chinese

Translated

Generates reports by aggregating project progress by status, priority, and size. A read-only skill that outputs completion rates and breakdowns of incomplete items by priority in tabular format. Use with commands like "Show progress", "Project report", "What's the completion rate?", "Number of items by status".

2installs

Sourcefandhe-ai/agent-cli-skills

Added on2026-05-11

NPX Install

npx skill4agent add fandhe-ai/agent-cli-skills project-view-status

SKILL.md Content (Chinese)

View Translation Comparison →

project-view-status

Aggregates project progress by status and priority to generate reports.

Prerequisites

The target GitHub Project exists
The
```
gh
```
CLI is installed and authenticated (with the
```
project
```
scope)

Flow

Step 1: Retrieve project information

bash

gh project view <number> --owner <owner> --format json

Retrieves the project's title, description, and URL.

Step 2: Retrieve all items

bash

gh project item-list <number> \
  --owner <owner> \
  --limit 999 \
  --format json

Step 3: Retrieve field definitions

bash

gh project field-list <number> \
  --owner <owner> \
  --format json

Retrieves definitions and option values for Status, Priority, and Size fields.

Step 4: Aggregate by status and priority

Processes JSON data to aggregate the following:

Number of items by status (Todo / In Progress / In Review / Done)
Number of items by priority (High / Medium / Low)
Cross-tabulation of Status × Priority
Completion rate (Done / Total items)

Step 5: Generate report

Outputs the report in the following format:

markdown

## Project Progress Report: <Title>

**Last Updated:** YYYY-MM-DD HH:MM

### Overall Progress
- Total Items: N
- Completion Rate: XX% (N/M)
- In Progress: N
- In Review: N
- Not Started: N

### By Status

| Status       | Count | Percentage |
|--------------|-------|------------|
| Done         | N     | XX%        |
| In Review    | N     | XX%        |
| In Progress  | N     | XX%        |
| Todo         | N     | XX%        |

### By Priority (Incomplete Only)

| Priority | Count | In Progress | Todo |
|----------|-------|-------------|------|
| High     | N     | N           | N    |
| Medium   | N     | N           | N    |
| Low      | N     | N           | N    |

### By Size (Incomplete Only)

| Size | Count |
|------|-------|
| XL   | N     |
| L    | N     |
| M    | N     |
| S    | N     |
| XS   | N     |

Notes

Use
```
--limit 999
```
to prevent pagination truncation
This is a read-only operation, so no changes are made to the project
Skip the corresponding section if the field does not exist
Report if there are 0 items
Use
GIT_SSL_NO_VERIFY=1
in sandbox environment: Refer to the "Execution in Sandbox Environment" section below for details

Execution in Sandbox Environment

When running this skill in a sandbox, consider using

GIT_SSL_NO_VERIFY=1

for GitHub operations over the network. The main remote operation of this skill is

gh project item-list

, and the "remote write" determination is Required (this skill is read-only). For details on command classification and notes on disabling TLS verification, refer to

docs/sandbox-tls.md

.

project-view-status

NPX Install

Tags

SKILL.md Content (Chinese)

project-view-status

Prerequisites

Flow

Step 1: Retrieve project information

Step 2: Retrieve all items

Step 3: Retrieve field definitions

Step 4: Aggregate by status and priority

Step 5: Generate report

Notes

Execution in Sandbox Environment