✨ feat: enhance commit message skill with issue reference suggestions (related to #2)

.vibe/skills/gitea-client/SKILL.md

@@ -183,6 +183,104 @@ Get the current status of a pull request.
 - `repo`: Repository name
 - `pr_number`: PR number
 
+### List Issues
+
+```bash
+skill gitea-client list-issues <owner> <repo> [state]
+```
+
+List issues for a repository.
+
+**Arguments:**
+- `owner`: Repository owner
+- `repo`: Repository name
+- `state`: Issue state (open, closed, all) - default: open
+
+**Examples:**
+```bash
+# List open issues
+gitea-client list-issues arcodange DanceLessonsCoach
+
+# List closed issues
+gitea-client list-issues arcodange DanceLessonsCoach closed
+
+# List all issues
+gitea-client list-issues arcodange DanceLessonsCoach all
+```
+
+### Create Issue
+
+```bash
+skill gitea-client create-issue <owner> <repo> <title> <description>
+```
+
+Create a new issue in the repository.
+
+**Arguments:**
+- `owner`: Repository owner
+- `repo`: Repository name
+- `title`: Issue title
+- `description`: Issue description (use quotes)
+
+**Examples:**
+```bash
+# Create a simple issue
+gitea-client create-issue arcodange DanceLessonsCoach "Bug in CI workflow" "The CI workflow fails on job 350"
+
+# Create detailed issue with multi-line description
+gitea-client create-issue arcodange DanceLessonsCoach "Optimize main branch workflow" "Current workflow has separate version bump and Docker build steps. Need to optimize by:
+
+1. Share artifacts between CI jobs for faster execution
+2. Combine version management and Docker build in single workflow
+3. Use proper job dependencies and artifact caching
+4. Reduce total CI time by avoiding redundant builds"
+```
+
+### Show Issue Details
+
+```bash
+skill gitea-client show-issue <owner> <repo> <issue_number>
+```
+
+Get detailed information about a specific issue.
+
+**Arguments:**
+- `owner`: Repository owner
+- `repo`: Repository name
+- `issue_number`: Issue number
+
+**Examples:**
+```bash
+# Show issue details
+gitea-client show-issue arcodange DanceLessonsCoach 42
+
+# Get issue and extract title
+gitea-client show-issue arcodange DanceLessonsCoach 42 | jq '.title'
+```
+
+### Comment on Issue
+
+```bash
+skill gitea-client comment-issue <owner> <repo> <issue_number> <comment>
+```
+
+Add a comment to an existing issue.
+
+**Arguments:**
+- `owner`: Repository owner
+- `repo`: Repository name
+- `issue_number`: Issue number
+- `comment`: Comment text (use quotes)
+
+**Examples:**
+```bash
+# Add simple comment
+gitea-client comment-issue arcodange DanceLessonsCoach 42 "Working on this now"
+
+# Add detailed update
+gitea-client comment-issue arcodange DanceLessonsCoach 42 "Created optimized workflow in .gitea/workflows/main-branch-optimized.yaml. Ready for testing."
+```
+
 ## Workflows
 
 ### Monitor CI/CD Job
@@ -217,6 +315,30 @@ skill gitea-client job-logs owner repo job_id > workflow_logs.txt
 skill gitea-client comment-pr owner repo pr_number "Job failed: analysis results"
 ```
 
+### Issue Management Workflow
+
+```bash
+# 1. List open issues
+gitea-client list-issues arcodange DanceLessonsCoach
+
+# 2. Create new issue for workflow optimization
+gitea-client create-issue arcodange DanceLessonsCoach "Optimize main branch workflow" "Current workflow has separate version bump and Docker build steps. Need to optimize by:
+
+1. Share artifacts between CI jobs for faster execution
+2. Combine version management and Docker build in single workflow
+3. Use proper job dependencies and artifact caching
+4. Reduce total CI time by avoiding redundant builds"
+
+# 3. Show issue details
+gitea-client show-issue arcodange DanceLessonsCoach 42
+
+# 4. Add progress comment
+gitea-client comment-issue arcodange DanceLessonsCoach 42 "Created optimized workflow in .gitea/workflows/main-branch-optimized.yaml. Ready for testing."
+
+# 5. Close issue when resolved
+gitea-client comment-issue arcodange DanceLessonsCoach 42 "✅ RESOLVED: Optimized workflow implemented and tested successfully."
+```
+
 ### Complete CI Debugging Workflow
 
 ```bash