org-wide-secret-migration

Migrate secrets, variables, deploy keys, and environments across organizations with gh secret-kit.

Updated Feb 22, 2026
One-click install
npx skills add https://github.com/srz-zumix/gh-secret-kit --skill org-wide-secret-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: org-wide-secret-migration
Source: https://github.com/srz-zumix/gh-secret-kit/tree/main/skills/org-wide-secret-migration
Command: npx skills add https://github.com/srz-zumix/gh-secret-kit --skill org-wide-secret-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrates all secrets, variables, deploy keys, and environments across an entire organization, eliminating manual, error-prone reconfiguration when changing orgs or consolidating security boundaries.

Core Features & Use Cases

  • Plan-driven migration: generates comprehensive commands with gh secret-kit migrate plan, tailored to repositories and environments.
  • Review, run, and verify: use migrate check to ensure all secrets and variables are present at the destination; run a central org-level runner to coordinate jobs across repositories.
  • Cross-host support: handles differences across hosts and environments; migrates deploy keys and environments where applicable.

Quick Start

Plan the migration by running gh secret-kit migrate plan source-org -d dest-org, review the generated script, start the org runner, then execute the script to complete the migration.

Frequently Asked Questions about org-wide-secret-migration

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

FAQPage Schema
How do I migrate secrets across all repositories in a GitHub organization?

Migrate secrets across a GitHub organization by generating a plan with gh secret-kit migrate plan, reviewing the script, starting a central org-level runner, and executing the script to complete the full migration.

Can I migrate GitHub environments and deploy keys along with secrets?

Yes, you can migrate GitHub environments and deploy keys along with secrets and variables. The migration process handles differences across hosts and environments, moving deploy keys and environments where applicable.

What is the best way to verify secrets are present after an org migration?

The best way to verify secrets after an org migration is to use the gh secret-kit migrate check command, which ensures all secrets and variables are present at the destination organization.

Does cross-host secret migration work for enterprise GitHub deployments?

Cross-host secret migration works for enterprise GitHub deployments by handling differences across hosts and environments, supporting multi-repo migrations across source and destination organizations.

Do I need to set up a runner to automate organization-wide secret migrations?

Yes, you need to run a central org-level runner to coordinate jobs across repositories. Start the runner after generating the migration plan, then execute the script to complete the automated migration.

Why does manual secret migration across organizations lead to errors?

Manual secret migration across organizations leads to errors due to manual, error-prone reconfiguration when changing orgs or consolidating security boundaries across multiple repositories and environments.