agentleFS
vbonkvbonk/repo-template/.claude/skills/hibernate/SKILL.md

hibernate

Skill8 starsChanged 3 months agoMITView on GitHub

Hibernate or un-hibernate a GitHub repo. Disables Actions, Dependabot alerts/fixes, Issues, Projects, and Wiki to stop automated resource consumption. Detects Pages and webhooks and tells you how to stop them (archiving covers webhooks; Pages needs a manual/explicit delete). Reversible for what it disabled — it records prior state and restores those settings on wake. Use when shutting down, pausing, or reactivating a repo. Triggers on "hibernate", "shut down repo", "pause repo", "deactivate repo", "un-hibernate", "reactivate repo", "wake up repo".

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 8 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈8

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If not in a git repo or no remote, ask the user for the repo name (owner/repo format).

    line 36
  2. Distinctive:

    If Actions disabled AND vulnerability alerts disabled AND issues disabled:

    line 66
  3. Distinctive:

    If also archived: "This repo is hibernated AND archived (read-only)."

    line 68
  4. Distinctive:

    Ask: "Would you like to un-hibernate it?"

    line 69
  5. Distinctive:

    If user says no, stop.

    line 70
  6. Distinctive:

    If user says yes, proceed to Un-hibernate Procedure.

    line 71
  7. Distinctive:

    If webhooks are detected, also ask:

    line 95
  8. Distinctive:

    Run these commands in order:

    line 100

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Hibernate Repo Skill

Safely put a GitHub repository into a dormant state (or bring it back). Stops all automated processes, prevents charges, and preserves the repo for future use.

When to Use

  • Shutting down a repo you're no longer actively developing
  • Pausing a project temporarily
  • Reducing GitHub Actions/Dependabot resource consumption
  • Reactivating a previously hibernated repo
  • Checking if a repo is already hibernated

Modes

ModeTrigger Phrases
Hibernate"hibernate this repo", "shut down this repo", "pause this repo", "deactivate"
Un-hibernate"un-hibernate", "reactivate this repo", "wake up this repo", "resume this repo"
Status check"is this repo hibernated?", "check hibernate status"

Hibernate Procedure

Step 1: Detect Current Repo

Determine the repo from the current working directory:

REPO=$(gh repo view --json nameWithOwner -q '.nameWithOwner' 2>/dev/null)

If not in a git repo or no remote, ask the user for the repo name (owner/repo format).

Step 2: Check Current State

Gather the current state of all features:

# Actions enabled?
gh api repos/$REPO/actions/permissions --jq '.enabled'

# Issues, Projects, Wiki, Pages
gh api repos/$REPO --jq '{issues: .has_issues, projects: .has_projects, wiki: .has_wiki, pages: .has_pages, archived: .archived}'

# Vulnerability alerts (Dependabot)
gh api repos/$REPO/vulnerability-alerts 2>&1
# 204 = enabled, 404 = disabled

# Active webhooks
gh api repos/$REPO/hooks --jq '.[].config.url'

# Active workflows
gh api repos/$REPO/actions/workflows --jq '.workflows[] | .name + " (" + .state + ")"'

# GitHub Pages
gh api repos/$REPO/pages --jq '.status' 2>&1
# 404 = no pages

Step 3: If Already Hibernated

If Actions disabled AND vulnerability alerts disabled AND issues disabled:

  • Report: "This repo is already hibernated."
  • If also archived: "This repo is hibernated AND archived (read-only)."
  • Ask: "Would you like to un-hibernate it?"
  • If user says no, stop.
  • If user says yes, proceed to Un-hibernate Procedure.

Step 4: Show Current State and Confirm

Display a table of what will be changed:

## Hibernate Plan for {REPO}

| Feature | Current | Will Be |
|---------|---------|---------|
| Actions | enabled | DISABLED |
| Dependabot alerts | enabled | DISABLED |
| Issues | enabled | DISABLED |
| Projects | enabled | DISABLED |
| Wiki | disabled | (no change) |
| Pages | none | (no change) |
| Webhooks | 2 active | (see below) |
| Archive | no | (optional) |

Use AskUserQuestion:

"This will disable Actions, Dependabot, Issues, and Projects on {REPO}. The repo remains writable and can be un-hibernated anytime. Proceed?"

If webhooks are detected, also ask:

"Found {N} webhook(s): {urls}. These will continue to fire unless removed or the repo is archived. Want to also archive the repo (makes it read-only, stops all webhook delivery)?"

Step 5: Execute Hibernate

Run these commands in order:

# 1. Disable GitHub Actions
gh api -X PUT repos/$REPO/actions/permissions -F enabled=false

# 2. Disable automated security fixes FIRST (the API requires vulnerability
# alerts to still be enabled when this runs — order matters)
gh api -X DELETE repos/$REPO/automated-security-fixes 2>/dev/null

# 3. Disable vulnerability alerts (Dependabot alerts)
gh api -X DELETE repos/$REPO/vulnerability-alerts

# 4. Disable Issues
gh api -X PATCH repos/$REPO -F has_issues=false

# 5. Disable Projects
gh api -X PATCH repos/$REPO -F has_projects=false

# 6. Disable Wiki (if enabled)
gh api -X PATCH repos/$REPO -F has_wiki=false

# 7. Disable Pages (if enabled)
# gh api -X DELETE repos/$REPO/pages  # Only if pages exist

# 8. OPTIONAL: Archive (if user confirmed)
# gh repo archive $REPO --yes

Step 6: Verify

Re-run the state checks from Step 2 and display results:

## Hibernate Complete: {REPO}

| Feature | Status |
|---------|--------|
| Actions | DISABLED |
| Dependabot | DISABLED |
| Issues | DISABLED |
| Projects | DISABLED |
| Wiki | DISABLED |
| Archived | yes/no |

The repo is now dormant. No workflows will run, no Dependabot PRs will be created,
no resource consumption or charges will accrue.

To reactivate: run /hibernate on this repo and choose un-hibernate.

Un-hibernate Procedure

Step 1: Check Current State

Same as Hibernate Step 2. Confirm the repo IS hibernated.

Step 2: If Not Hibernated

Report: "This repo is not hibernated — all features are active." Stop.

Step 3: If Archived

Use AskUserQuestion:

"This repo is archived (read-only). Un-archiving will make it writable again. Proceed?"

If yes:

gh repo unarchive $REPO --yes

Step 4: Confirm Re-enable Scope

Use AskUserQuestion:

"Which features should be re-enabled? (Default: Actions + Dependabot + Issues)

  1. Standard (Actions, Dependabot, Issues) — recommended
  2. Minimal (Actions only — just enough to run CI)
  3. Full (Actions, Dependabot, Issues, Projects, Wiki)
  4. Custom — I'll tell you which ones"

Step 5: Execute Un-hibernate

Based on user's choice:

# Re-enable Actions
gh api -X PUT repos/$REPO/actions/permissions -F enabled=true -f allowed_actions=all

# Re-enable vulnerability alerts
gh api -X PUT repos/$REPO/vulnerability-alerts

# Re-enable Issues
gh api -X PATCH repos/$REPO -F has_issues=true

# Re-enable Projects (if requested)
gh api -X PATCH repos/$REPO -F has_projects=true

# Re-enable Wiki (if requested)
gh api -X PATCH repos/$REPO -F has_wiki=true

Step 6: Verify and Report

Same verification pattern as Hibernate Step 6, showing what was re-enabled.

Important Notes

  • Hibernation is fully reversible — nothing is deleted, just disabled
  • Archiving is also reversible — gh repo unarchive makes it writable again
  • Webhooks survive hibernation unless the repo is archived — mention this to the user
  • Vercel/Netlify connections — if the repo is connected to a deployment platform, mention that auto-deploys will stop but existing deployments remain live
  • GitHub free tier — Actions minutes and Dependabot are free for public repos, but still worth disabling to prevent noise. Private repos have minute limits.
  • Dependabot security fixes can only be disabled while vulnerability alerts are enabled — disable alerts first, then fixes become moot
  • Always verify after changes — the API can silently fail on some operations

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.