skill-issues
FeaturedTrack project blockers, bugs, and gaps across sessions — use when issues pile up or need triage
AI & Automation 4,061 stars
380 forks Updated today MIT
Install
Quality Score: 99/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# Issue Tracking
## Overview
Cross-session issue tracking for persistent problem management. Issues are stored in `.octo/ISSUES.md` and survive across Claude Code sessions.
**Core principle:** Track → Resolve → Learn.
---
## When to Use
**Use this skill when user wants to:**
- Track a problem or blocker for later
- Record issues discovered during development
- Review open issues across sessions
- Mark issues as resolved
- View details of specific issues
**Do NOT use for:**
- GitHub issue management (use gh CLI)
- Git-tracked issues (use git commands)
- Temporary todos (use TodoWrite)
---
## Subcommands
### 1. List Issues (Default)
**Trigger:** `/octo:issues` or `/octo:issues list`
Show all open issues in table format:
```markdown
## Open Issues
| ID | Severity | Category | Description | Created | Phase |
|----|----------|----------|-------------|---------|-------|
| ISS-20260203-001 | high | integration | Auth not working | 2026-02-03 | Develop |
| ISS-20260203-002 | medium | performance | Slow query performance | 2026-02-03 | Deliver |
```
**Pattern Detection:** After listing, check if 3+ open issues share the same category. If so, alert:
```text
⚠ Pattern detected: 3 open issues in category "integration" — may indicate a systemic problem.
```
**Implementation:**
1. Check if `.octo/ISSUES.md` exists
2. If not, initialize from template
3. Read and parse Open Issues section
4. Display in table format
---
### 2. Add Issue
**Trigger:** `/octo:issues add <descr...
Details
- Author
- nyldn
- Repository
- nyldn/claude-octopus
- Created
- 7 months ago
- Last Updated
- today
- Language
- Shell
- License
- MIT
Integrates with
Bundled in these plugins
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Listed
issues
Track, search, and manage development issues and their solutions
0 Updated 2 weeks ago
ostin-pil AI & Automation Listed
to-issues
Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices. Use when user wants to convert a plan into issues, create implementation tickets, or break down work into issues.
1 Updated today
yusufkaracaburun AI & Automation Featured
skill-intake
Move incoming issues and pull requests through triage states until each is actionable or closed — use when the queue has piled up or a report arrives unsorted
4,061 Updated today
nyldn