agent-ops-report
Generate markdown reports from issues. Filter by type, priority, epic, date range. Supports summary, detailed, progress, completion, velocity, and backlog analysis views.
npx skills add majiayu000/claude-skill-registry --skill agent-ops-report-weholt-script-cast --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Report Generation Skill **Works with or without `aoc` CLI installed.** Report data can be gathered via direct file reading. ## Goal Generate informative reports from issue data to help users understand project status, prioritize work, analyze velocity, and review history. Supports multiple output formats and automatic clarification handoff. ## Data Retrieval (File-Based — Default) Reports are generated by reading issue files directly: | Data Source | How to Retrieve | |-------------|-----------------| | All issues | Read `.agent/issues/{critical,high,medium,low}.md` | | Completed issues | Read `.agent/issues/history.md` | | Epic progress | Search for `epic:` field across priority files | | Blocked issues | Search for `status: blocked` in priority files | ### File-Based Report Generation 1. **Summary Report**: Count issues in each priority file, group by type 2. **Completion Report**: Parse `history.md` for date ranges, group by type/epic 3. **Velocity Report**: Count issues by date from `### Log` entries 4. **Backlog Analysis**: Calculate age from `created:` field in each issue 5. **Epic Progress**: Filter issues by `epic:` field, calculate completion % ## CLI Integration (when a
- Goal
- Data Retrieval (File-Based — Default)
- File-Based Report Generation
- CLI Integration (when aoc is available)
- Export for Reports (CLI)
- Report Types
- 1. Summary Report (default)
- 2. Completion Report (NEW)
- 3. Progress/Velocity Report (ENHANCED)
- 4. Backlog Analysis Report (NEW)
- 5. Session History Report (NEW)
- 6. Epic Progress Report
- 7. Detailed Report
- Output Formats
Export all open issues as JSON aoc issues list --json > open-issues.json Export by priority for summary report aoc issues list --priority critical --json aoc issues list --priority high --json Export epic progress data aoc issues list --epic "authentication" --json Include completed issues for history report aoc issues list --done --json
What does the agent-ops-report skill do?
Generate markdown reports from issues. Filter by type, priority, epic, date range. Supports summary, detailed, progress, completion, velocity, and backlog analysis views.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill agent-ops-report-weholt-script-cast --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.