.cursor/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/corp_site-type01 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)
- Behavior: docs/behavior.md (if behavior mapping changed)
| 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]"
development
Bootstraps project documentation for an existing repository by reading the codebase, README, tests, and package metadata, then creates or updates docs/overview.md, docs/behavior.md, and ADRs when significant architectural decisions are discovered. Use when asked to document a repo, extract project purpose, write overview/behavior docs, review an existing codebase, or capture architecture decisions from source.
development
Creates or updates docs/overview.md — the project's purpose and background. Load when starting a new project, when the project's goals or context have changed, or when docs/overview.md does not exist. Covers what to write, what to omit, and how to keep the document agent-friendly.
documentation
Implements a new feature using docs-first delivery, boundary-driven structure, and skeleton-first execution. Load when adding a route, feature, or new user-visible behavior.
development
When creating or refining ideas, ask the user detailed questions until a shared understanding is reached, and work through each branch of the decision tree one by one. Use this approach if you want to be rigorously questioned about an idea, or if you’ve specifically asked to be “grill me.”.