.github/skills/issue/SKILL.md
Manages GitHub Issues using gh CLI — creation, decomposition, update, and close. Load when asked to create a new issue, break down a large task into issues, update issue status or labels, or close an issue after a PR is merged. Human decides whether to create an issue. Agent handles all gh CLI operations.
npx skillsauth add poko8nada/pj_docs issueInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Good scope (1 PR完結)
Too large — decompose first
When asked to implement something large, list the decomposed Issues for human approval before creating them.
# Single issue
gh issue create \
--title "[concise action-oriented title]" \
--body "[context, acceptance criteria, references]" \
--label "[label]" \
--assignee "@me"
# Decompose a large task — list first, then create after approval
gh issue create --title "..." --body "..." --assignee "@me"
gh issue create --title "..." --body "..." --assignee "@me"
gh issue list --state open --assignee "@me"
gh issue view [number]
gh issue edit [number] --title "..." --body "..."
gh issue edit [number] --add-label "in-progress" --remove-label "todo"
# Close when PR is merged
gh issue close [number] --comment "Resolved in PR #[pr-number]"
## Context
[Why this needs to be done]
## Acceptance Criteria
- [ ] [specific verifiable condition]
- [ ] [specific verifiable condition]
## References
- Related: #[issue-number]
- ADR: docs/adr/NNNN-\*.md (if applicable)
| Label | Meaning |
| ---------- | ----------------------------------- |
| bug | Something is broken |
| feature | New capability |
| refactor | Code change with no behavior change |
| docs | Documentation only |
| chore | Tooling, config, dependencies |
Always reference the issue:
# Commit
git commit -m "feat: add [feature] (#[issue-number])"
# PR — closes issue automatically on merge
gh pr create \
--title "feat: [title] (#[issue-number])" \
--body "Closes #[issue-number]"
tools
Composite Skill. This skill is used for project planning. Users request that a project plan be created, particularly during the initial stages.
documentation
Core Skill. This skill is for document creation. User ask you to create planning documents, such as requirement and task breakdown.
development
Core Skill. Next.js 15+ App Router architecture guidelines including component patterns, state management with Zustand, server actions, and project structure. Use when developing Next.js applications.
development
Core Skill. HonoX architecture guidelines including file-based routing, Islands pattern, component types, performance optimization, and best practices for full-stack development.