# Generate GitHub Elements Workflow Reports

GitHub Elements teams need structured visibility into workflow health, metrics, and epic progress. This skill produces detailed reports for metrics, compliance, and epic analysis.

## Install

```bash
npx skillstore add emasoft/ghe-report
```

## Metadata

- Status: approved
- Slug: emasoft-ghe-report
- Skillstore revision: r1
- Version status: missing
- Tree hash: f08c8429240cd82ff6a6ecac2238176d062e9e9e6defdad548dc29156eda5a1c
- Author: Emasoft
- GitHub username: Emasoft
- License: MIT
- Repository: https://github.com/Emasoft/ghe-marketplace/tree/main/plugins/ghe/skills/ghe-report
- Ref: 30c73eac2afe762f6aa9c4553158769369d47351
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/emasoft-ghe-report
- Manifest: https://skillstore.pages.dev/api/skills/emasoft-ghe-report/manifest

## Capabilities

- Generates metrics reports covering throughput, cycle time, review rate, demotion rate, and agent comparison.
- Generates health reports for compliance, stale threads, violations, memory bank status, and overall health.
- Generates epic reports with thread history, current phase, technical decisions, and remaining work.
- Directs reports to both the GitHub issue thread and the GHE\_REPORTS directory.
- Applies the documented report filename format with timestamp, title, and agent name.
- Adjusts report detail based on local GitHub Elements settings when available.

## Use Cases

- Review Delivery Trends: Create a metrics report before planning to review throughput, cycle time, review pass rate, and demotion rate.
- Audit Workflow Health: Check compliance status, stale threads, violation history, memory bank synchronization, and overall workflow health.
- Summarize Epic Progress: Produce an epic report with issue history, current phase, key decisions, and estimated remaining work.

## Prompt Templates

### Create a Metrics Report

```
Use ghe-report to create a metrics report for the current GitHub Elements project. Include throughput, cycle times, and quality metrics.
```

### Check Workflow Health

```
Use ghe-report to create a health report. Include compliance status, stale threads, violation history, memory bank status, and health rating.
```

### Summarize an Epic

```
Use ghe-report to create an epic report for [epic name]. Include thread history, current phase, decisions, and remaining work.
```

### Compare Metrics and Health

```
Use ghe-report to produce a combined analysis for the last sprint. Compare metrics, health risks, stale threads, and recommended follow-up actions.
```

## Limitations

- It depends on an available reporter agent and GitHub Elements project context.
- It does not define how metrics are collected from GitHub data.
- It may require access to local project files and report directories.
- The current instructions include risky permission language for writing to Claude settings.

## Best Practices

- Confirm the report type before asking the skill to run.
- Provide the epic name when requesting an epic report.
- Review report destinations before posting sensitive project details.

## Anti Patterns

- Asking for a report without project or epic context.
- Using the detailed report when only a quick status is needed.
- Allowing edits to user-level Claude settings without review.

## Security Audit

- Audited at: 2026-07-05T15:51:19.033\+00:00
- Summary: Most external-command and network-reconnaissance flags are false positives caused by Markdown examples and report text. The audit confirms a real filesystem risk from permission to write to ~/.claude and identifies an unsafe prompt-injection style instruction hierarchy.

## Stats

- Views: 209
- Downloads: 9
- Favorites: 0
- Popularity score: 0