GitHub Features Skill Skill

GitHub Features Skill

Production-Grade Platform Skill | Version 2.0.0

Leveraging GitHub platform capabilities.

Skill Contract

Input Schema

input:
  type: object
  properties:
    feature:
      type: string
      enum: [pr, issue, actions, projects, releases]
    operation:
      type: string
      enum: [create, list, view, update, close, merge]
    target:
      type: object
      properties:
        owner:
          type: string
        repo:
          type: string
        number:
          type: integer

Output Schema

output:
  type: object
  required: [result, success]
  properties:
    result:
      type: string
    success:
      type: boolean
    url:
      type: string
      format: uri
    rate_limit:
      type: object
      properties:
        remaining: integer

Error Handling

Retry Logic

retry_config:
  max_attempts: 4
  backoff_type: exponential
  initial_delay_ms: 2000
  max_delay_ms: 16000
  jitter: true
  retryable:
    - 502_bad_gateway
    - 503_service_unavailable
    - 429_rate_limited
  non_retryable:
    - 401_unauthorized
    - 404_not_found

Rate Limit Strategy

rate_limit:
  check_before_request: true
  buffer_percentage: 10
  on_limit_reached:
    - wait_for_reset
    - batch_remaining_operations

GitHub CLI (`gh`)

# Auth
gh auth login
gh auth status

# PRs
gh pr create --title "Title" --body "Body"
gh pr list
gh pr merge 123 --squash

# Issues
gh issue create --title "Bug" --body "Description"
gh issue list --state open

# Actions
gh run list
gh run view 123

GitHub Actions

Basic CI Workflow

name: CI
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm ci
      - run: npm test

Branch Protection

protection_rules:
  - require_pull_request_reviews:
      required_approving_review_count: 2
  - require_status_checks:
      strict: true
      contexts: [ci, lint, test]
  - allow_force_pushes: false

Troubleshooting Guide

Debug Checklist

□ 1. Auth status: gh auth status
□ 2. Rate limits: gh api rate_limit
□ 3. CLI version: gh --version

Common Issues

| Error | Cause | Solution | |-------|-------|----------| | "401 Unauthorized" | Invalid token | gh auth refresh | | "403 Forbidden" | No permission | Check token scopes | | "rate limit exceeded" | Too many calls | Wait for reset |

Features Matrix

| Feature | CLI Command | Use Case | |---------|-------------|----------| | PRs | gh pr | Code review | | Issues | gh issue | Bug tracking | | Actions | gh run | CI/CD | | Releases | gh release | Distribution |

Observability

logging:
  events:
    - api_call_completed
    - rate_limit_warning

metrics:
  - api_calls_per_session
  - rate_limit_usage

"GitHub is not just hosting - it's a complete development platform."

Agent Skills: GitHub Features Skill

Skill Files