Tooluck logoTooluck
SKILL.md

skill-issues

Agent skill fromnyldn/claude-octopus

Track project blockers, bugs, and gaps across sessions — use when issues pile up or need triage

How to install skill-issues

install skill-issues
# install the claude-octopus pack with the skills CLI
npx skills add nyldn/claude-octopus

# or add only this skill to Claude Code: copy the folder

skills/skill-issues/

# into

~/.claude/skills/skill-issues/ (all projects)

.claude/skills/skill-issues/ (one project)

skills/skill-issues/SKILL.md

MITFull file
1> **Host: Codex CLI** — This skill was designed for Claude Code and adapted for Codex.
2> Cross-reference commands use installed skill names in Codex rather than `/octo:*` slash commands.
3> Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it.
4> For host tool equivalents, see `skills/blocks/codex-host-adapter.md`.
5
6
7# Issue Tracking
8
9## Overview
10
11Cross-session issue tracking for persistent problem management. Issues are stored in `.octo/ISSUES.md` and survive across Claude Code sessions.
12
13**Core principle:** Track → Resolve → Learn.
14
15
16## When to Use
17
18**Use this skill when user wants to:**
19- Track a problem or blocker for later
20- Record issues discovered during development
21- Review open issues across sessions
22- Mark issues as resolved
23- View details of specific issues
24
25**Do NOT use for:**
26- GitHub issue management (use gh CLI)
27- Git-tracked issues (use git commands)
28- Temporary todos (use task plan tool)
29
30
31## Subcommands
32
33### 1. List Issues (Default)
34
35**Trigger:** `/octo:issues` or `/octo:issues list`
36
37Show all open issues in table format:
38
39```markdown
40## Open Issues
41
42| ID | Severity | Category | Description | Created | Phase |
43|----|----------|----------|-------------|---------|-------|
44| ISS-20260203-001 | high | integration | Auth not working | 2026-02-03 | Develop |
45| ISS-20260203-002 | medium | performance | Slow query performance | 2026-02-03 | Deliver |
46```
47…

Excerpt shown under the repository's MIT license.

More skills in claude-octopus

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates