github-token-permissions-overview

Apply least-privilege GITHUB_TOKEN permissions across GitHub Actions workflows.

3|3|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/adaptive-enforcement-lab/claude-skills --skill github-token-permissions-overview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-token-permissions-overview
Source: https://github.com/adaptive-enforcement-lab/claude-skills/tree/main/plugins/secure/skills/github-token-permissions-overview
Command: npx skills add https://github.com/adaptive-enforcement-lab/claude-skills --skill github-token-permissions-overview

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GitHub Actions workflows often run with too-broad GITHUB_TOKEN permissions. This Skill guides you to enforce explicit, minimal permissions to reduce risk from misconfigurations, accidental exposures, or compromised actions.

Core Features & Use Cases

  • Define and apply least-privilege permission policies to GitHub workflows.
  • Provide practical examples and templates for common CI, PR, and deployment scenarios.
  • Help security teams and software engineers mitigate risk by documenting and enforcing minimal scopes.

Quick Start

Start with a minimal permissions block in your workflow and escalate only as failures demand.

Frequently Asked Questions about github-token-permissions-overview

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

FAQPage Schema
How do I enforce least-privilege permissions for GITHUB_TOKEN in GitHub Actions workflows?

To enforce least-privilege permissions for GITHUB_TOKEN, you define explicit, minimal permission blocks in your GitHub Actions workflow files. This restricts token scopes across CI, pull requests, and deployments to reduce risk from accidental exposures.

Why do my GitHub Actions workflows run with overly broad GITHUB_TOKEN permissions by default?

GitHub Actions workflows often default to broad GITHUB_TOKEN permissions, which creates security risks from misconfigurations or compromised actions. Applying explicit least-privilege scopes mitigates this by granting only the minimum access required.

What is the best way to restrict GitHub Actions token access for CI and pull requests?

The best way to restrict GitHub Actions token access is to start with a minimal permissions block in your workflow and escalate only as failures demand. This enforces least-privilege policies for safe CI and pull request automation.

Can I apply least-privilege GITHUB_TOKEN policies across all repository workflows?

Yes, you can apply least-privilege GITHUB_TOKEN policies across repository workflows. This ensures explicit permissions are enforced uniformly in workflow files, securing continuous integration and deployment steps against compromised actions.

When do I need to define explicit permissions in GitHub Actions workflow files?

You need to define explicit permissions in GitHub Actions workflow files whenever your automation runs in CI, pull requests, or deployment steps. This enforces minimal scopes and reduces the risk of misconfigurations or accidental exposures.