Ios Teardown

Purpose

Reverse the setup performed by /ios-kit (/ios-scaffold → /github-hooks → /github-secure). Removes local project files, git hooks, and optionally deletes the GitHub repo.

Arguments

• --keep-repo — Keep the GitHub repo (default: delete the repo)
• --keep-local — Keep local files, only clean up remote resources
• --dry-run — Show what would be deleted without doing it

Workflow

1. Detect project

Verify the current directory is an ios-kit project:

1. Check for project.yml, App/Sources/, and CLAUDE.md
2. Read project.yml to extract the project name
3. Detect GitHub remote: git remote get-url origin
4. Extract owner/repo from the remote URL

If any check fails, abort with a clear message about what's missing.

2. Pre-flight safety checks

Before proceeding, check for uncommitted or unpushed work:

1. Uncommitted changes — Run git status --porcelain. If output is non-empty, warn the user and list the changes. Require explicit confirmation to continue.
2. Unpushed commits — Run git log @{upstream}..HEAD --oneline 2>/dev/null. If there are unpushed commits, warn the user and list them. Require explicit confirmation to continue.
3. gh auth — Run gh auth status. If not authenticated and repo deletion is needed (no --keep-repo), abort and instruct the user to run gh auth login.

3. Dry-run report

Always display this report before any destructive action, regardless of --dry-run:

=== Teardown Plan ===

Project: 
GitHub:  

Will delete:
  ☐ GitHub repo:           (skip: --keep-repo)
  ☐ Branch protection on main           (skip: --keep-repo)
  ☐ Local project directory:      (skip: --keep-local)
  ☐ Git hooks path config               (skip: --keep-local)

Will keep:
  ☐ 

• If --dry-run, print the report and stop here.
• Otherwise, ask: "Proceed with teardown? (yes/no)" — require the user to confirm.

4. Remove GitHub resources (unless --keep-repo)

Execute in this order (protections must be removed before repo deletion):

1. Remove branch protection:

``bash gh api -X DELETE /repos/{owner}/{repo}/branches/main/protection ``

1. Delete the repo:

``bash gh repo delete {owner}/{repo} --yes ``

If --keep-repo:

• Skip all repo operations
• Suggest archiving: "Consider archiving with gh repo archive {owner}/{repo} --yes"
• Print the GitHub URL for future reference

5. Clean up local (unless --keep-local)

1. Reset git hooks path (if configured):

``bash git config --unset core.hooksPath ``

1. Capture the project directory path and navigate to the parent:

``bash PROJECT_DIR=$(pwd) cd .. ``

1. Delete the project directory:

``bash rm -rf "$PROJECT_DIR" ``

6. Confirm

Print a summary of what was deleted:

=== Teardown Complete ===

Deleted:
  ✓ GitHub repo: 
  ✓ Local directory: 
  ✓ Git hooks config

Kept:
  — 

If the repo was kept, include: GitHub: https://github.com//

Safety guardrails

• Never run without confirmation — always show the dry-run report and require explicit "yes"
• Check for uncommitted changes — warn and require override
• Check for unpushed commits — warn and require override
• Verify gh auth before GitHub operations
• No --force flag — destructive actions always require confirmation
• Order matters — remove branch protection before repo deletion
• No Write tool — this skill only deletes, never creates files

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: edfenton
• Source: edfenton/claude-skills
• License: MIT

Install and usage instructions live in the source repository linked above.