OpenParable
Skip to content
← Back to skills

Git Platform

Apps & Automation
git-platform

Git Platform is an Agent Skill for apps & automation published in the athola/claude-night-market repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Detects git forge (GitHub/GitLab/Bitbucket) and maps CLI commands cross-platform. Use when writing skills that must run on any git hosting provider.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/athola/claude-night-market/blob/HEAD/plugins/leyline/skills/git-platform/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/git-platform, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Table of Contents

Git Platform Detection & Command Mapping

Overview

Cross-platform abstraction for git forge operations. Detects whether the current project uses GitHub, GitLab, or Bitbucket, and provides equivalent CLI commands for each platform.

The SessionStart hook (detect-git-platform.sh) automatically injects the detected platform into session context. This skill provides the command reference for translating operations across platforms.

When To Use

  • Before running gh, glab, or forge API commands
  • When a skill or command needs to create issues, PRs/MRs, or post comments
  • When writing CI/CD configuration
  • Any time forge-specific CLI commands appear in a workflow

When NOT To Use

  • Local-only git operations (git commit, git branch, etc.)
  • Projects without a hosted git remote

Platform Detection

Detection is automatic via the SessionStart hook. The session context will contain:

git_platform: github|gitlab|bitbucket, cli: gh|glab, mr_term: pull request|merge request

If you need to re-detect manually:

# Check remote URL
git remote get-url origin 2>/dev/null

# Check file markers
ls -d .github/ .gitlab-ci.yml bitbucket-pipelines.yml 2>/dev/null

# Check CLI availability
command -v gh && echo "GitHub CLI available"
command -v glab && echo "GitLab CLI available"

Quick Command Reference

OperationGitHub (gh)GitLab (glab)
View issuegh issue view N --json title,body,labelsglab issue view N
List issuesgh issue list --json number,titleglab issue list
Create issuegh issue create --title "T" --body "B"glab issue create --title "T" --description "B"
Close issuegh issue close Nglab issue close N
Comment on issuegh issue comment N --body "msg"glab issue note N --message "msg"
View PR/MRgh pr view Nglab mr view N
Create PR/MRgh pr create --title "T" --body "B"glab mr create --title "T" --description "B"
List PR/MR commentsgh api repos/O/R/pulls/N/commentsglab mr note list N
Current PR/MRgh pr view --json numberglab mr view --json iid
Resolve threadsgh api graphqlglab api graphql
Repo infogh repo view --json owner,nameglab repo view

For Bitbucket: No standard CLI exists. Use REST API (curl) or the web interface. See command-mapping module for API equivalents.

Terminology

ConceptGitHubGitLabBitbucket
Code review unitPull Request (PR)Merge Request (MR)Pull Request (PR)
CI configuration.github/workflows/*.yml.gitlab-ci.ymlbitbucket-pipelines.yml
Default branchmainmainmain
Review commentsPR review commentsMR discussion notesPR comments

Important: When the platform is GitLab, always say "merge request" (not "pull request") in user-facing output, commit messages, and comments.

Integration Pattern

Skills that perform forge operations should:

  1. Declare dependencies: [leyline:git-platform]
  2. Check the session context for git_platform:
  3. Use the command mapping table above
  4. Fall back gracefully if CLI is unavailable
# Example skill instruction pattern:

## Step N: Create PR/MR

Use the detected platform CLI (check session context for `git_platform`):
- **GitHub**: `gh pr create --title "..." --body "..."`
- **GitLab**: `glab mr create --title "..." --description "..."`
- **Bitbucket**: Create via web interface

Detailed Resources

  • Full command mapping: See modules/command-mapping.md for complete API equivalents, GraphQL queries, and Bitbucket REST API patterns
  • Authentication: See Skill(leyline:authentication-patterns) for ensure_auth github|gitlab

Exit Criteria

  • Platform detected (or explicitly unknown)
  • Correct CLI tool used for all forge operations
  • Platform-appropriate terminology in user-facing output