aws-github-oidc-scoped-role

Configure AWS IAM OIDC trust scoped to GitHub Actions workflows.

320|3|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/mizchi/skills --skill aws-github-oidc-scoped-role
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aws-github-oidc-scoped-role
Source: https://github.com/mizchi/skills/tree/main/aws/github-oidc-scoped-role
Command: npx skills add https://github.com/mizchi/skills --skill aws-github-oidc-scoped-role

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide helps safely connect GitHub Actions workflows to AWS by establishing a tightly scoped OIDC trust, preventing broad access to AWS resources.

Core Features & Use Cases

  • OIDC provider setup for GitHub Actions with proper verification and scope controls.
  • Scope trust to a specific workflow file using the job_workflow_ref pattern to limit access to a single workflow.
  • Include Bedrock/inference pattern guidance and necessary AWS Marketplace permissions for AI agent workflows.
  • Enforce ReadOnlyAccess with explicit Deny patterns to prevent credential leakage and data exfiltration.

Quick Start

Configure an AWS OIDC provider for GitHub Actions and reference the scoped role in your workflow's permissions.

Frequently Asked Questions about aws-github-oidc-scoped-role

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scope AWS OIDC trust to a specific GitHub Actions workflow?

To scope AWS OIDC trust to a specific GitHub Actions workflow, configure the IAM role trust policy using the job_workflow_ref pattern. This limits role assumption strictly to that single workflow file, preventing broader AWS access.

What is the job_workflow_ref pattern in AWS IAM OIDC?

The job_workflow_ref pattern is an OIDC sub claim used in AWS IAM trust policies. It identifies the exact GitHub Actions workflow file requesting access, allowing you to tightly restrict role assumption to that specific workflow.

How do I prevent credential leakage when using GitHub Actions OIDC with AWS?

Prevent credential leakage in GitHub Actions OIDC by enforcing ReadOnlyAccess alongside explicit Deny patterns. This blocks data exfiltration and restricts destructive actions while securely assuming the tightly scoped AWS IAM role.

Does AWS Bedrock require specific marketplace permissions for GitHub Actions workflows?

Yes, AWS Bedrock inference patterns within GitHub Actions workflows require specific AWS Marketplace permissions. You must configure these necessary permissions within your scoped IAM role to properly execute AI agent tasks.

What are the limitations of relying solely on ReadOnlyAccess for AWS OIDC roles?

ReadOnlyAccess for AWS OIDC roles prevents direct resource modification but cannot stop data exfiltration. You must add explicit Deny patterns to block credential leakage and secure sensitive data from unauthorized access.