Skip to content

aiskillstore/marketplace / skills/1gy/managing-branches

managing-branches

Verified

Investigates and creates Git branches. Triggered when: branch status check, new branch creation, branch-related errors.

FileKindSize
SKILL.mdskill md1.2 KB
skill-report.jsonconfig14.5 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-04T15:03:22.175Z",
    "slug": "1gy-managing-branches",
    "source_url": "https://github.com/1gy/jpp/tree/main/.claude/skills/managing-branches",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "6816355969c534f6d4bcfcffdf1d39449cd34460bcc8a2f9478ba881b7b7b585",
    "tree_hash": "b0a0092b8eb282ae260089bfae0e3c7c00aec25767bcd5b952ff197dce97b3ee",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "managing-branches",
    "description": "Guides safe Git branch checks, branch creation, sync review, and conflict reporting for repository work.",
    "summary": "Inspect branch state, create branches from a base, and report Git issues clearly.",
    "icon": "📦",
    "version": "1.0.1",
    "author": "1gy",
    "license": "MIT",
    "tags": [
      "git",
      "branch-management",
      "version-control",
      "repository-workflow",
      "devops"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "filesystem"
    ],
    "category": "devops"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "Static findings are false positives caused by Markdown code fences, inline command formatting, and harmless stderr redirection. No prompt injection, data exfiltration intent, or hidden unsafe behavior was found in SKILL.md.",
    "remediation": [
      {
        "issue": "Placeholder branch arguments need careful handling.",
        "suggestion": "State that branch names must be copied from Git refs or validated before use in shell commands.",
        "severity": "low"
      },
      {
        "issue": "Branch creation changes repository state.",
        "suggestion": "Ask for user confirmation before creating a new branch when uncommitted work exists.",
        "severity": "low"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 11,
            "line_end": 17
          },
          {
            "file": "SKILL.md",
            "line_start": 17,
            "line_end": 23
          },
          {
            "file": "SKILL.md",
            "line_start": 23,
            "line_end": 26
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 33
          },
          {
            "file": "SKILL.md",
            "line_start": 33,
            "line_end": 34
          },
          {
            "file": "SKILL.md",
            "line_start": 34,
            "line_end": 39
          },
          {
            "file": "SKILL.md",
            "line_start": 39,
            "line_end": 41
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 16,
            "line_end": 16
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:11:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 11,
        "line_end": 17,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 17,
        "line_end": 23,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 23,
        "line_end": 26,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 26,
        "line_end": 33,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 33,
        "line_end": 34,
        "snippet": "| Uncommitted changes | `git stash` or commit first |"
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 34,
        "line_end": 39,
        "snippet": "| Remote sync error | `git fetch --all` retry |"
      },
      {
        "id": "external_commands:SKILL.md:39:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 39,
        "line_end": 41,
        "snippet": "1. `git status` to identify conflicts"
      },
      {
        "id": "filesystem:SKILL.md:16:standard-device-file-access",
        "category": "filesystem",
        "severity": "low",
        "pattern": "Standard device file access",
        "file": "SKILL.md",
        "line_start": 16,
        "line_end": 16,
        "snippet": "git rev-list --count <main-branch>..HEAD 2>/dev/null || echo \"0\"  # Check CLAUDE.md for main branch "
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:11:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The finding points to a Markdown bash fence that documents Git inspection commands. It is not Ruby backtick execution or hidden dynamic shell evaluation."
      },
      {
        "id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The line closes the Markdown code fence for visible Git commands. There is no executable script body or obfuscated command execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The finding marks a Markdown bash fence before branch creation examples. The commands are plain Git workflow instructions, not Ruby shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The line closes a Markdown code fence after visible Git checkout examples. No evidence shows concealed shell execution beyond the documented Git operation."
      },
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The inline backticks format a suggested git stash command in a table. This is documentation for handling local changes, not code that executes automatically."
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The inline backticks format a git fetch retry suggestion in a table. The text is a visible Git troubleshooting instruction, not dynamic command execution."
      },
      {
        "id": "external_commands:SKILL.md:39:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.89,
        "reason": "The inline backticks format git status as a conflict investigation step. It is a normal read-only Git command shown to the user, not a hidden execution primitive."
      },
      {
        "id": "filesystem:SKILL.md:16:standard-device-file-access",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The /dev/null redirection only suppresses stderr for a Git commit count command. It does not read sensitive device files or access user data directly."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 51,
    "audit_model": "codex",
    "audited_at": "2026-07-04T15:03:22.175Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Manage Git Branches Safely",
    "value_statement": "Branch state can be unclear during active repository work. This skill guides Claude, Codex, and Claude Code through focused Git checks and branch creation steps.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "Git branch management",
      "branch creation",
      "repository workflow",
      "version control",
      "Git status",
      "conflict resolution",
      "developer productivity"
    ],
    "actual_capabilities": [
      "Checks the current Git branch and short working tree status.",
      "Fetches remote branch information before reporting sync status.",
      "Counts commits ahead of the configured main branch.",
      "Creates a new local branch from a selected remote base branch.",
      "Reports branch conflicts, permission errors, and remote sync issues."
    ],
    "limitations": [
      "It depends on Git being installed and available in the repository.",
      "It does not resolve complex merge conflicts without user guidance.",
      "It needs a known main branch name for accurate ahead counts.",
      "It can only work with remotes configured in the local repository."
    ],
    "use_cases": [
      {
        "title": "Review Branch State Before Coding",
        "description": "Check the active branch, local changes, remote sync state, and commits ahead of main before starting work.",
        "target_user": "Software developer"
      },
      {
        "title": "Create Feature Branches Consistently",
        "description": "Fetch a base branch and create a new local branch from the matching remote branch.",
        "target_user": "Implementation agent operator"
      },
      {
        "title": "Diagnose Branch Workflow Errors",
        "description": "Identify existing branches, uncommitted changes, remote fetch issues, permission errors, and conflict status.",
        "target_user": "Engineering lead"
      }
    ],
    "prompt_templates": [
      {
        "title": "Check My Branch",
        "scenario": "Beginner branch inspection",
        "prompt": "Use the managing-branches skill to check the current branch, local changes, remote sync status, and commits ahead of main."
      },
      {
        "title": "Create A Feature Branch",
        "scenario": "Routine branch creation",
        "prompt": "Use the managing-branches skill to create a new feature branch from origin/main. Report any uncommitted changes before creating it."
      },
      {
        "title": "Investigate Branch Error",
        "scenario": "Troubleshooting a failed branch operation",
        "prompt": "Use the managing-branches skill to investigate why branch creation failed. Check existing branches, remote sync, permissions, and local changes."
      },
      {
        "title": "Prepare Branch Report",
        "scenario": "Advanced repository handoff",
        "prompt": "Use the managing-branches skill to produce a branch readiness report with current branch, changes, ahead count, remote state, and required user decisions."
      }
    ],
    "output_examples": [
      {
        "input": "Check whether this repository is ready for new work.",
        "output": "Current branch is feature/login. There are two modified files. Remote tracking is current. The branch is three commits ahead of main."
      },
      {
        "input": "Create a branch for the billing update from main.",
        "output": "Created the requested branch from origin/main. No local changes were present. Remote branch information was fetched before creation."
      },
      {
        "input": "Why did my branch operation fail?",
        "output": "The target branch already exists and local changes are present. Choose the existing branch, provide a new name, or commit the changes first."
      }
    ],
    "best_practices": [
      "Run the branch check before creating or switching branches.",
      "Confirm the intended base branch before creating new work branches.",
      "Resolve or save local changes before branch operations that change state."
    ],
    "anti_patterns": [
      "Creating branches without checking for uncommitted local work.",
      "Assuming the main branch name without checking project guidance.",
      "Continuing through complex conflicts without asking the user."
    ],
    "faq": [
      {
        "question": "What does this skill inspect first?",
        "answer": "It checks the current branch, local changes, remote branch state, and commits ahead of the main branch."
      },
      {
        "question": "Can it create a new branch?",
        "answer": "Yes. It can fetch a base branch and create a local branch from the matching remote branch."
      },
      {
        "question": "Does it resolve merge conflicts?",
        "answer": "It identifies conflict status and asks for guidance when resolution is complex."
      },
      {
        "question": "Does it require network access?",
        "answer": "It may contact configured Git remotes when fetching branch information."
      },
      {
        "question": "Which tools can use it?",
        "answer": "The report lists support for Claude, Codex, and Claude Code."
      },
      {
        "question": "Is it safe for repositories with local changes?",
        "answer": "It reports local changes first and recommends saving or committing work before risky branch operations."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 51
    }
  ]
}
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall