Skip to content
Skills Library
Programming · Tool integration

git-platform

/git-platform

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

Licence
MIT
Last repository change
01.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 01.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

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

Original author description

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

How it works

  1. Overview
  2. When To Use
  3. When NOT To Use
  4. Platform Detection
  5. Quick Command Reference
  6. Terminology
  7. Integration Pattern
  8. Detailed Resources
  9. Exit Criteria
Original SKILL.md headings · 103 lines, 615 words
SKILL.md preview
---
name: git-platform
description: Detects git forge (GitHub/GitLab/Bitbucket) and maps CLI commands cross-platform. Use when writing skills that must run on any git hosting provider.
alwaysApply: false
category: infrastructure
tags:
- git
- platform
- github
- gitlab
- bitbucket
- cross-platform
- forge
dependencies:
- authentication-patterns
provides:
  infrastructure:
  - platform-detection
  - command-mapping
  - forge-abstraction
  patterns:
  - cross-platform-git
  - cli-selection
  - terminology-mapping
usage_patterns:
- platform-detection
- command-translation
- cross-platform-workflows
complexity: beginner
model_hint: fast
estimated_tokens: 400
progressive_loading: true
modules:
- modules/command-mapping.md
role: library
---

# 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:

```bash
# 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

| Operation | GitHub (`gh`) | GitLab (`glab`) |
|-----------|---------------|-----------------|
| View issue | `gh issue view N --json title,body,labels` | `glab issue view N` |
| List issues | `gh issue list --json number,title` | `glab issue list` |
| Create issue | `gh issue create --title "T" --body "B"` | `glab issue create --title "T" --description "B"` |
| Close issue | `gh issue close N` | `glab issue close N` |
| Comment on issue | `gh issue comment N --body "msg"` | `glab issue note N --message "msg"` |
| View PR/MR | `gh pr view N` | `glab mr view N` |
| Create PR/MR | `gh pr create --title "T" --body "B"` | `glab mr create --title "T" --description "B"` |
| List PR/MR comments | `gh api repos/O/R/pulls/N/comments` | `glab mr note list N` |
| Current PR/MR | `gh pr view --json number` | `glab mr view --json iid` |
| Resolve threads | `gh api graphql` | `glab api graphql` |
| Repo info | `gh repo view --json owner,name` | `glab repo view` |

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

## Terminology

| Concept | GitHub | GitLab | Bitbucket |
|---------|--------|--------|-----------|
| Code review unit | Pull Request (PR) | Merge Request (MR) | Pull Request (PR) |
| CI configuration | `.github/workflows/*.yml` | `.gitlab-ci.yml` | `bitbucket-pipelines.yml` |
| Default branch | `main` | `main` | `main` |
| Review comments | PR review comments | MR discussion notes | PR 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

```markdown
# 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](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
Files in this package (2)
  • SKILL.md 5 KB
  • modules/command-mapping.md 8 KB

Versions

The database has no other skills named git-platform.

Database snapshot: 13.11.2026 · package version a493fd68809f (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100git
    Git and code hosting platform management — GitHub, GitLab, Codeberg, Forgejo. Zero barrier — install x-cmd and manage repos from the terminal. Use for "git", "github", "gitlab", "repo", "pull request", "code hosting".
  • 100x-git
    This skill provides comprehensive Git and code hosting platform management tools through x-cmd CLI, including GitHub, GitLab, Codeberg, Forgejo integration, and Git hooks management. This skill should be used when users need to manage Git repositories, work with code hosting…
  • 90bkt
    Operate Bitbucket Cloud or Data Center repositories, pull requests, branches, pipelines, permissions, and webhooks with bkt. Use when a request names Bitbucket or bkt; confirm the platform before platform-specific commands.
  • 100coderabbit
    CodeRabbit reviews pull requests with AI on GitHub, GitLab, Azure DevOps and Bitbucket, and reviews local changes from a CLI before they are pushed. Use when a user asks to set up automated PR reviews, write or validate a .coderabbit.yaml, add path-specific review instructions,…
  • 92bitbucket
    Interact with Bitbucket repositories and pull requests using the BITBUCKET_TOKEN environment variable. Use when working with code hosted on Bitbucket or managing Bitbucket resources via API.
  • 100bitbucket
    Bitbucket integration hub. Detects whether the repository is on Bitbucket Cloud or Bitbucket Data Center and directs you to the matching detailed skill (bitbucket-cloud or bitbucket-data-center). Use for any Bitbucket repository or pull request task.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.