aiden-runtime 3.19.5 → 3.19.7

package/workspace-templates/skills/github-issues/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: github-issues
+description: Create, list, view, and manage GitHub issues using the gh CLI
+category: developer
+version: 1.0.0
+origin: aiden
+license: Apache-2.0
+tags: github, issues, bug-tracker, gh-cli, labels, milestones, comments, triage, project-management
+---
+
+# GitHub Issues Management
+
+Manage GitHub issues — create, list, view, label, assign, and close issues — using the `gh` CLI. Requires `gh auth login` (see github-auth skill) or `GH_TOKEN` environment variable.
+
+## When to Use
+
+- User wants to create a bug report or feature request issue
+- User wants to list open issues in a repository
+- User wants to add a comment or close an issue
+- User wants to filter issues by label, assignee, or milestone
+- User wants to bulk-triage or update multiple issues
+
+## How to Use
+
+### 1. List open issues
+
+```powershell
+# List open issues in current repo
+gh issue list
+
+# List with specific filters
+gh issue list --state open --label bug --limit 20
+
+# List issues assigned to me
+gh issue list --assignee @me
+```
+
+### 2. View an issue
+
+```powershell
+gh issue view 42
+gh issue view 42 --comments
+```
+
+### 3. Create a new issue
+
+```powershell
+# Interactive (opens editor)
+gh issue create
+
+# Non-interactive with all fields
+gh issue create --title "Login fails on mobile Safari" --body "Steps to reproduce:
+1. Open app on iOS Safari
+2. Tap Sign In
+3. Form submits but returns to login page
+
+Expected: successful login. Actual: redirect loop." --label bug --assignee "@me"
+```
+
+### 4. Add a comment
+
+```powershell
+gh issue comment 42 --body "Investigated — root cause is a CSRF token mismatch. Fix in progress."
+```
+
+### 5. Edit an issue (labels, assignees, milestone, title)
+
+```powershell
+# Add a label
+gh issue edit 42 --add-label "priority:high"
+
+# Remove a label and add another
+gh issue edit 42 --remove-label bug --add-label wont-fix
+
+# Assign to someone
+gh issue edit 42 --add-assignee johndoe
+
+# Change title
+gh issue edit 42 --title "Login redirect loop on mobile Safari"
+```
+
+### 6. Close and reopen issues
+
+```powershell
+# Close (resolved)
+gh issue close 42 --comment "Fixed in v2.1.3"
+
+# Close as not planned
+gh issue close 42 --reason "not planned"
+
+# Reopen
+gh issue reopen 42
+```
+
+### 7. Search issues across repos
+
+```powershell
+# Search open issues mentioning a keyword
+gh issue list --repo owner/repo --search "authentication token" --state all
+
+# GitHub search syntax in --search
+gh issue list --repo owner/repo --search "label:bug created:>2026-01-01"
+```
+
+### 8. Bulk operations
+
+```powershell
+# Close all issues with a specific label
+gh issue list --label "duplicate" --limit 100 --json number | 
+  python -c "import json,sys; [print(i['number']) for i in json.load(sys.stdin)]" |
+  ForEach-Object { gh issue close $_ --reason "not planned" }
+```
+
+## Examples
+
+**"Create a GitHub issue for the login bug we just found"**
+→ Use step 3 with title, body describing steps to reproduce, and `--label bug`.
+
+**"Show me all open bugs assigned to me in this repo"**
+→ Use step 1: `gh issue list --label bug --assignee @me`.
+
+**"Close issue 42 and add a comment that it's fixed"**
+→ Use step 6: `gh issue close 42 --comment "Fixed in latest release"`.
+
+## Cautions
+
+- `gh` must be authenticated — run `gh auth status` to verify before use
+- Labels must already exist in the repository — creating non-existent labels with `--add-label` will error
+- Bulk operations cannot be undone — confirm with the user before closing multiple issues
+- Issue numbers are repository-specific — always confirm the correct repo with `--repo owner/repo` for multi-repo workflows

package/workspace-templates/skills/github-issues/skill.json

@@ -0,0 +1,25 @@
+{
+  "name": "github-issues",
+  "version": "1.0.0",
+  "description": "Create, list, view, and manage GitHub issues using the gh CLI",
+  "author": "aiden",
+  "license": "MIT",
+  "tools": [],
+  "trigger_phrases": [],
+  "compatible_agents": [
+    "aiden"
+  ],
+  "min_agent_version": "3.0.0",
+  "tags": [
+    "github",
+    "issues",
+    "bug-tracker",
+    "gh-cli",
+    "labels",
+    "milestones",
+    "comments",
+    "triage",
+    "project-management"
+  ],
+  "created": "2026-04-27T17:11:39.674Z"
+}

package/workspace-templates/skills/github-pr-workflow/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: github-pr-workflow
+description: Full pull request lifecycle — create, review, merge, and manage PRs using the gh CLI
+category: developer
+version: 1.0.0
+origin: aiden
+license: Apache-2.0
+tags: github, pull-request, pr, review, merge, gh-cli, code-review, workflow, branch, diff
+---
+
+# GitHub Pull Request Workflow
+
+Manage the full lifecycle of GitHub pull requests — create, review, approve, request changes, merge, and clean up — using the `gh` CLI.
+
+## When to Use
+
+- User wants to create a pull request from the current branch
+- User wants to review or approve a PR
+- User wants to merge a PR after approval
+- User wants to check PR status, checks, or reviews
+- User wants to list open PRs or find a specific PR
+
+## How to Use
+
+### 1. Create a pull request
+
+```powershell
+# Interactive (opens editor for body)
+gh pr create
+
+# Non-interactive with all fields
+gh pr create --title "feat: add user authentication" --body "## Summary
+- Add JWT-based auth
+- Add login/logout endpoints
+- Add middleware for protected routes
+
+## Test plan
+- [ ] Login with valid credentials
+- [ ] Reject invalid credentials
+- [ ] Access protected route with token" --base main --draft
+```
+
+### 2. List open PRs
+
+```powershell
+gh pr list
+gh pr list --state all --limit 20
+gh pr list --author "@me"
+gh pr list --label "ready for review"
+```
+
+### 3. View PR details and diff
+
+```powershell
+# View PR summary
+gh pr view 15
+
+# View with comments
+gh pr view 15 --comments
+
+# Show diff
+gh pr diff 15
+```
+
+### 4. Check PR status and CI checks
+
+```powershell
+gh pr checks 15
+gh pr status   # shows PRs relevant to you (authored, assigned, review requested)
+```
+
+### 5. Review a PR (approve / request changes / comment)
+
+```powershell
+# Approve
+gh pr review 15 --approve --body "LGTM! Clean implementation."
+
+# Request changes
+gh pr review 15 --request-changes --body "Please add unit tests for the auth middleware."
+
+# Leave a general comment
+gh pr review 15 --comment --body "Looks mostly good — just one question inline."
+```
+
+### 6. Merge a PR
+
+```powershell
+# Squash merge (recommended for feature branches)
+gh pr merge 15 --squash --delete-branch
+
+# Merge commit (preserves all commits)
+gh pr merge 15 --merge
+
+# Rebase merge
+gh pr merge 15 --rebase --delete-branch
+```
+
+### 7. Checkout a PR locally
+
+```powershell
+# Checkout a PR branch for local testing
+gh pr checkout 15
+
+# Return to main when done
+git checkout main
+```
+
+### 8. Edit a PR (title, body, labels, reviewers)
+
+```powershell
+# Mark draft as ready for review
+gh pr ready 15
+
+# Add reviewer
+gh pr edit 15 --add-reviewer alice,bob
+
+# Add label
+gh pr edit 15 --add-label "ready for review"
+```
+
+### 9. Close a PR without merging
+
+```powershell
+gh pr close 15 --comment "Closing in favour of PR #16 which takes a different approach."
+```
+
+## Examples
+
+**"Create a PR from my current branch to main"**
+→ Use step 1 — fill in title and body describing the changes and test plan.
+
+**"Show me what CI checks are failing on PR 15"**
+→ Use step 4: `gh pr checks 15` to see check names, status, and links to logs.
+
+**"Approve PR 22 and merge it with squash"**
+→ Use step 5 to approve, then step 6 with `--squash --delete-branch`.
+
+## Cautions
+
+- Always check CI status (`gh pr checks`) before merging — do not merge PRs with failing required checks
+- `--delete-branch` removes the remote branch after merge — confirm this is desired
+- Squash merge rewrites history — use merge commit for PRs where individual commit history matters
+- Merging from `gh pr merge` requires merge permissions — the user needs write access to the repo

package/workspace-templates/skills/github-pr-workflow/skill.json

@@ -0,0 +1,26 @@
+{
+  "name": "github-pr-workflow",
+  "version": "1.0.0",
+  "description": "Full pull request lifecycle — create, review, merge, and manage PRs using the gh CLI",
+  "author": "aiden",
+  "license": "MIT",
+  "tools": [],
+  "trigger_phrases": [],
+  "compatible_agents": [
+    "aiden"
+  ],
+  "min_agent_version": "3.0.0",
+  "tags": [
+    "github",
+    "pull-request",
+    "pr",
+    "review",
+    "merge",
+    "gh-cli",
+    "code-review",
+    "workflow",
+    "branch",
+    "diff"
+  ],
+  "created": "2026-04-27T17:11:39.693Z"
+}

package/workspace-templates/skills/github-repo-management/SKILL.md

@@ -0,0 +1,147 @@
+---
+name: github-repo-management
+description: Create, clone, fork, archive, and manage GitHub repositories using gh CLI and git
+category: developer
+version: 1.0.0
+origin: aiden
+license: Apache-2.0
+tags: github, repository, repo, clone, fork, branch, gh-cli, git, remote, management
+---
+
+# GitHub Repository Management
+
+Create, clone, fork, configure, and manage GitHub repositories using the `gh` CLI and `git`. Covers repo creation, branch management, secrets, and repo settings.
+
+## When to Use
+
+- User wants to create a new GitHub repository
+- User wants to clone or fork an existing repository
+- User wants to list repositories in an organization or for a user
+- User wants to manage branches (list, create, protect, delete)
+- User wants to add or list GitHub Actions secrets
+
+## How to Use
+
+### 1. Create a new repository
+
+```powershell
+# Create public repo and clone locally
+gh repo create my-new-project --public --clone
+
+# Create private repo with description
+gh repo create my-new-project --private --description "Internal API service"
+
+# Create repo from local directory
+cd "C:\Users\shiva\Projects\myapp"
+gh repo create my-new-project --source=. --private --push
+```
+
+### 2. Clone a repository
+
+```powershell
+# Clone via gh (handles auth automatically)
+gh repo clone owner/repo-name
+
+# Clone to specific directory
+gh repo clone owner/repo-name ./local-folder
+
+# Clone with SSH explicitly
+git clone git@github.com:owner/repo-name.git
+```
+
+### 3. Fork a repository
+
+```powershell
+# Fork to your account and clone locally
+gh repo fork owner/repo-name --clone
+
+# Fork to an organization
+gh repo fork owner/repo-name --org my-org
+```
+
+### 4. List repositories
+
+```powershell
+# Your repos
+gh repo list --limit 30
+
+# Organization repos
+gh repo list my-org --limit 50
+
+# Filter by language
+gh repo list --language python --limit 20
+```
+
+### 5. Manage branches
+
+```powershell
+# List remote branches
+git branch -r
+
+# Create and push a new branch
+git checkout -b feature/my-feature
+git push -u origin feature/my-feature
+
+# Delete a remote branch
+git push origin --delete feature/old-branch
+
+# List branches via gh
+gh api repos/owner/repo/branches | python -m json.tool
+```
+
+### 6. View and update repo settings
+
+```powershell
+# View repo details
+gh repo view owner/repo-name
+
+# View in browser
+gh repo view owner/repo-name --web
+
+# Edit repo description and topics
+gh repo edit owner/repo-name --description "Updated description" --add-topic "api,python"
+```
+
+### 7. Manage GitHub Actions secrets
+
+```powershell
+# List secrets
+gh secret list
+
+# Set a secret
+gh secret set DATABASE_URL --body "postgresql://user:pass@host/db"
+
+# Set from a file
+gh secret set PRIVATE_KEY < private_key.pem
+
+# Delete a secret
+gh secret delete OLD_SECRET
+```
+
+### 8. Archive or delete a repository
+
+```powershell
+# Archive (read-only, not deleted)
+gh repo archive owner/repo-name
+
+# Delete — IRREVERSIBLE — direct user to do this manually
+# gh repo delete owner/repo-name --yes  ← do not run this for the user
+```
+
+## Examples
+
+**"Create a new private GitHub repo for my Python scripts"**
+→ Use step 1: `gh repo create my-python-scripts --private --clone`.
+
+**"Fork the fastapi repository so I can contribute"**
+→ Use step 3: `gh repo fork tiangolo/fastapi --clone`.
+
+**"Add my API key as a GitHub Actions secret"**
+→ Use step 7: `gh secret set API_KEY --body "..."`.
+
+## Cautions
+
+- Repository deletion is IRREVERSIBLE — never run `gh repo delete` for the user; direct them to do it in the GitHub web UI
+- Archiving a repo makes it read-only but does not delete it — safe to run
+- Secrets set with `gh secret set` are write-only in the GitHub UI — they cannot be read back after creation
+- Forking a private repo copies it to your account — ensure the original owner's license permits this

package/workspace-templates/skills/github-repo-management/skill.json

@@ -0,0 +1,26 @@
+{
+  "name": "github-repo-management",
+  "version": "1.0.0",
+  "description": "Create, clone, fork, archive, and manage GitHub repositories using gh CLI and git",
+  "author": "aiden",
+  "license": "MIT",
+  "tools": [],
+  "trigger_phrases": [],
+  "compatible_agents": [
+    "aiden"
+  ],
+  "min_agent_version": "3.0.0",
+  "tags": [
+    "github",
+    "repository",
+    "repo",
+    "clone",
+    "fork",
+    "branch",
+    "gh-cli",
+    "git",
+    "remote",
+    "management"
+  ],
+  "created": "2026-04-27T17:11:39.714Z"
+}

package/workspace-templates/skills/google-workspace/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: google-workspace
+description: Interact with Gmail, Google Calendar, Drive, Sheets, and Docs via the Google API with service account or OAuth credentials
+category: productivity
+version: 1.0.0
+origin: aiden
+license: Apache-2.0
+tags: google, gmail, calendar, drive, sheets, docs, workspace, api, oauth, email
+---
+
+# Google Workspace Integration
+
+Access Gmail, Google Calendar, Drive, Sheets, and Docs through the Google REST APIs. Requires either a service account JSON key (`GOOGLE_APPLICATION_CREDENTIALS`) or an OAuth2 access token.
+
+## When to Use
+
+- User wants to read or send Gmail messages
+- User wants to list or create Google Calendar events
+- User wants to read/write a Google Sheet
+- User wants to list Google Drive files
+- User wants to read or update a Google Doc
+
+## How to Use
+
+### 1. Authenticate — OAuth token (quickest)
+
+Get a short-lived access token via `gcloud` CLI (requires Google Cloud SDK installed):
+
+```powershell
+# One-time login (opens browser)
+gcloud auth login
+# Get token for API calls
+$token = (gcloud auth print-access-token)
+$headers = @{ "Authorization" = "Bearer $token" }
+```
+
+For service accounts, set `GOOGLE_APPLICATION_CREDENTIALS` to the JSON key path and use `gcloud auth application-default print-access-token`.
+
+### 2. List recent Gmail messages
+
+```powershell
+$resp = Invoke-RestMethod -Uri "https://gmail.googleapis.com/gmail/v1/users/me/messages?maxResults=10" -Headers $headers
+$resp.messages | ForEach-Object {
+  $msg = Invoke-RestMethod -Uri "https://gmail.googleapis.com/gmail/v1/users/me/messages/$($_.id)?format=metadata&metadataHeaders=Subject,From,Date" -Headers $headers
+  $msg.payload.headers | Where-Object { $_.name -in @("Subject","From","Date") } | Select-Object name,value
+}
+```
+
+### 3. List today's Calendar events
+
+```powershell
+$now   = [System.DateTime]::UtcNow.ToString("yyyy-MM-ddTHH:mm:ssZ")
+$end   = [System.DateTime]::UtcNow.AddDays(1).ToString("yyyy-MM-ddTHH:mm:ssZ")
+$resp  = Invoke-RestMethod -Uri "https://www.googleapis.com/calendar/v3/calendars/primary/events?timeMin=$now&timeMax=$end&singleEvents=true&orderBy=startTime" -Headers $headers
+$resp.items | Select-Object summary, @{N="start";E={$_.start.dateTime}}
+```
+
+### 4. Read a Google Sheet
+
+```powershell
+$spreadsheetId = "your-sheet-id"   # from URL: /spreadsheets/d/<id>/
+$range         = "Sheet1!A1:E20"
+$resp = Invoke-RestMethod -Uri "https://sheets.googleapis.com/v4/spreadsheets/$spreadsheetId/values/$range" -Headers $headers
+$resp.values | ForEach-Object { $_ -join "`t" }
+```
+
+### 5. Write to a Google Sheet
+
+```powershell
+$spreadsheetId = "your-sheet-id"
+$range         = "Sheet1!A1"
+$writeHeaders  = $headers.Clone(); $writeHeaders["Content-Type"] = "application/json"
+$payload = @{ values = @(@("Name","Score"),@("Alice","95"),@("Bob","87")) } | ConvertTo-Json
+Invoke-RestMethod -Uri "https://sheets.googleapis.com/v4/spreadsheets/$spreadsheetId/values/$range`?valueInputOption=RAW" -Method Put -Headers $writeHeaders -Body $payload
+```
+
+### 6. List Google Drive files
+
+```powershell
+$resp = Invoke-RestMethod -Uri "https://www.googleapis.com/drive/v3/files?pageSize=20&fields=files(id,name,mimeType,modifiedTime)" -Headers $headers
+$resp.files | Select-Object name, mimeType, modifiedTime | Format-Table -AutoSize
+```
+
+### 7. Read a Google Doc
+
+```powershell
+$docId = "your-doc-id"   # from URL: /document/d/<id>/
+$resp  = Invoke-RestMethod -Uri "https://docs.googleapis.com/v1/documents/$docId" -Headers $headers
+$resp.body.content | Where-Object { $_.paragraph } |
+  ForEach-Object { $_.paragraph.elements.textRun.content } | Where-Object { $_ } | Out-String
+```
+
+## Examples
+
+**"Show me my unread Gmail emails from today"**
+→ Use step 2 with query parameter `q=is:unread after:2026/04/17`.
+
+**"What meetings do I have tomorrow?"**
+→ Use step 3 with tomorrow's date range for `timeMin`/`timeMax`.
+
+**"Read the sales data from my Google Sheet"**
+→ Use step 4 with the sheet ID from the URL and the relevant range.
+
+## Cautions
+
+- OAuth tokens expire after 1 hour — refresh with `gcloud auth print-access-token` as needed
+- Service account must be granted Workspace domain-wide delegation to impersonate users
+- Google Sheets API ranges use A1 notation — specify exact range to avoid reading entire sheet
+- Drive API returns a maximum of 1000 files per page; use `nextPageToken` for pagination
+- Sending emails requires the `gmail.send` scope — confirm scope during OAuth setup

package/workspace-templates/skills/google-workspace/skill.json

@@ -0,0 +1,26 @@
+{
+  "name": "google-workspace",
+  "version": "1.0.0",
+  "description": "Interact with Gmail, Google Calendar, Drive, Sheets, and Docs via the Google API with service account or OAuth credentials",
+  "author": "aiden",
+  "license": "MIT",
+  "tools": [],
+  "trigger_phrases": [],
+  "compatible_agents": [
+    "aiden"
+  ],
+  "min_agent_version": "3.0.0",
+  "tags": [
+    "google",
+    "gmail",
+    "calendar",
+    "drive",
+    "sheets",
+    "docs",
+    "workspace",
+    "api",
+    "oauth",
+    "email"
+  ],
+  "created": "2026-04-27T17:11:39.741Z"
+}