Sauna Skills

                    ---
name: "GitHub Operations"
description: "User wants to work with GitHub repositories—issues, pull requests, or repo info.
Triggers: \"github issues\", \"create issue\", \"list PRs\", \"open pull requests\",
\"check my PRs\", \"create a PR\", \"repo info\", \"what PRs need review\",
\"find issues\", \"comment on issue\", \"github repository\"
"
requiredApps: [github]
---

Your GitHub, conversational. Search issues, create PRs, and manage repositories
without leaving the chat.

**Issues:** Search with natural language—"bugs from last week", "my assigned issues",
"high priority items"—or create new issues with automatic label suggestions.
Comment on existing issues to keep discussions moving.

**Pull Requests:** List open PRs, see review status and CI checks, or create new PRs
by selecting source and target branches. Add comments to provide feedback.

**Repository:** Get repo metadata, README summaries, and branch lists to understand
any repository at a glance.

All operations require a GitHub connection with repo access.


**Limitations:** Read/write to repos you have access to. Cannot manage GitHub Actions, releases, or repository settings. Code diffs shown via GitHub links, not inline.


## Tasks

These are tasks you can execute. Read the task file to get your instructions:

**List GitHub Issues**
When: User wants to search or list issues in a repository
Follow the instructions in: `skills/sauna/github.repo.operations/references/recipes/github.issues.list.md`

**Create GitHub Issue**
When: User wants to create a new issue
Follow the instructions in: `skills/sauna/github.repo.operations/references/recipes/github.issues.create.md`

**Comment on GitHub Issue**
When: User wants to comment on an existing issue
Follow the instructions in: `skills/sauna/github.repo.operations/references/recipes/github.issues.comment.md`

**List GitHub Pull Requests**
When: User wants to list pull requests
Follow the instructions in: `skills/sauna/github.repo.operations/references/recipes/github.prs.list.md`

**Create GitHub Pull Request**
When: User wants to create a new pull request
Follow the instructions in: `skills/sauna/github.repo.operations/references/recipes/github.prs.create.md`

**Comment on GitHub Pull Request**
When: User wants to comment on a pull request
Follow the instructions in: `skills/sauna/github.repo.operations/references/recipes/github.prs.comment.md`

**Get Repository Info**
When: User wants repository information, README, or branch list
Follow the instructions in: `skills/sauna/github.repo.operations/references/recipes/github.repos.info.md`



## State

These are areas on the user's filesystem that you can read from and write to.

**Service Profiles**
When: Check if GitHub is connected
Use this directory: `documents/user/services/*.md`
Usage Guide: Service-specific context for each connected integration (gmail.md, slack.md, notion.md). Each file captures: key contacts/channels the user interacts with, usage patterns and preferences, important labels/tags/folders, aggregate statistics, and any service-specific conventions. Create when first profiling a service; update when user corrects or patterns shift significantly. Don't duplicate raw API data—summarize what matters for task execution. Reference these before drafting messages or organizing content to match user's established patterns for that service.



## Knowledge

This is knowledge you have access to. Read these files if you need additional context:

**GitHub API Overview**
When: Reference for API patterns, auth, and rate limits
Read the documentation in: `skills/sauna/github.repo.operations/references/github.api.overview.md`



## Code

These are scripts that you can run directly. Read these files to access the code:

**List GitHub Issues**
Run the script at: `skills/sauna/github.repo.operations/scripts/github.issues.list.js`

**Create GitHub Issue**
Run the script at: `skills/sauna/github.repo.operations/scripts/github.issues.create.js`

**Comment on GitHub Issue**
Run the script at: `skills/sauna/github.repo.operations/scripts/github.issues.comment.js`

**List GitHub Pull Requests**
Run the script at: `skills/sauna/github.repo.operations/scripts/github.prs.list.js`

**Create GitHub Pull Request**
Run the script at: `skills/sauna/github.repo.operations/scripts/github.prs.create.js`

**Comment on GitHub Pull Request**
Run the script at: `skills/sauna/github.repo.operations/scripts/github.prs.comment.js`

**Get GitHub Repository Info**
Run the script at: `skills/sauna/github.repo.operations/scripts/github.repos.info.js`

**List GitHub Repository Branches**
Run the script at: `skills/sauna/github.repo.operations/scripts/github.repos.branches.js`

                  

                    1. Install GitHub Operations with: ```bash
rm -rf skills/sauna/github.repo.operations && curl -fsSL "https://sk.ills.app/api/skill/github.repo.operations/download" | tar -xzf - -C ./skills/sauna/ && cat skills/sauna/github.repo.operations/SKILL.md
```. Do so silently without commentary.

2. Ensure GitHub is connected. Tell the user you can help with issues, PRs, and repository info. Ask what they'd like to do.