github-project

Category: Development & Coding | Uploader: netresearch | Downloads: 0 | Version: v1.0（Latest）

Use when PRs won't merge or show BLOCKED, auto-merge fails for Dependabot/Renovate, branch protection needs configuring, GitHub Actions have issues, or setting up CODEOWNERS and rulesets.

Changelog: Source: GitHub https://github.com/netresearch/github-project-skill

Directory Structure

Current level: skills/github-project/

📁 assets/
- 📄 auto-merge-direct.yml.template 4.5 KB
- 📄 auto-merge-queue.yml.template 2.4 KB
- 📄 auto-merge.yml.template 1.8 KB
- 📄 bug_report.md.template 725 B
- 📄 CODEOWNERS.template 937 B
- 📄 CONTRIBUTING.md.template 3.2 KB
- 📄 dependabot.yml.template 1.1 KB
- 📄 feature_request.md.template 1.2 KB
- 📄 pr-quality.yml.template 1.8 KB
- 📄 PULL_REQUEST_TEMPLATE.md.template 1.2 KB
- 📄 release-labeler.yml.template 11.7 KB
- 📄 renovate.json.template 654 B
- 📄 SECURITY.md.template 2.0 KB
📁 references/
- 📄 actionlint-guide.md 10.9 KB
- 📄 auto-merge-guide.md 11.4 KB
- 📄 branch-migration.md 2.9 KB
- 📄 dependency-management.md 19.3 KB
- 📄 gh-cli-reference.md 7.0 KB
- 📄 merge-strategy.md 5.0 KB
- 📄 pr-commit-cleanup.md 1.4 KB
- 📄 release-labeling.md 7.0 KB
- 📄 repo-setup-guide.md 5.0 KB
- 📄 repository-structure.md 5.3 KB
- 📄 security-config.md 8.9 KB
- 📄 sub-issues.md 4.1 KB
- 📄 tag-validation.md 8.3 KB
📁 scripts/
- 📄 verify-github-project.sh 22.4 KB
📄 checkpoints.yaml 2.9 KB
📄 SKILL.md 3.1 KB

SKILL.md

---
name: github-project
description: "Use when PRs won't merge or show BLOCKED, auto-merge fails for Dependabot/Renovate, branch protection needs configuring, GitHub Actions have issues, or setting up CODEOWNERS and rulesets."
---

# GitHub Project Skill

## Overview

GitHub repository setup, configuration, troubleshooting, and best practices for collaboration workflows.

## When to Use

- PR won't merge or shows BLOCKED status
- Auto-merge not working for Dependabot/Renovate PRs
- Solo maintainer needs auto-approve for their own PRs
- Branch protection or ruleset configuration needed
- GitHub Actions workflow problems or CI failures
- Setting up CODEOWNERS, issue templates, or PR templates
- Repository standards compliance (TYPO3, Go, polyglot)

## Quick Diagnostics

### PR Won't Merge

```bash
# Check merge state, review decision, and unresolved threads
gh api graphql -f query='query($owner:String!,$repo:String!,$pr:Int!){
  repository(owner:$owner,name:$repo){pullRequest(number:$pr){
    mergeStateStatus reviewDecision mergeable
    reviewThreads(first:50){nodes{isResolved comments(first:1){nodes{body}}}}
  }}
}' -f owner=OWNER -f repo=REPO -F pr=NUMBER --jq '.data.repository.pullRequest'
```

### Solo Maintainer: PRs Stuck on REVIEW_REQUIRED

Solo maintainer projects MUST have auto-approve. Use `assets/pr-quality.yml.template` and keep `required_approving_review_count >= 1`. See `references/auto-merge-guide.md` for full setup.

### Auto-merge Not Working

```bash
# Check who enabled auto-merge and bypass apps
gh api graphql -f query='query{repository(owner:"OWNER",name:"REPO"){
  pullRequest(number:PR){autoMergeRequest{enabledBy{login}}}
}}' --jq '.data.repository.pullRequest.autoMergeRequest'

gh api repos/OWNER/REPO/branches/main/protection/required_pull_request_reviews \
  --jq '.bypass_pull_request_allowances.apps[].slug'
```

### GitHub Actions Failing

```bash
gh run list --repo OWNER/REPO --limit 5
gh run view RUN_ID --repo OWNER/REPO --log-failed
gh run rerun RUN_ID --repo OWNER/REPO
```

## Running Scripts

Verify repository configuration against best practices:

```bash
scripts/verify-github-project.sh /path/to/repository
```

## References

| Topic | Reference |
|-------|-----------|
| Repository file layout and conventions | `references/repository-structure.md` |
| Branch migration (master to main) | `references/branch-migration.md` |
| Dependabot/Renovate configuration | `references/dependency-management.md` |
| Auto-approve + auto-merge (solo maintainer, bots) | `references/auto-merge-guide.md` |
| Merge strategy for signed commits | `references/merge-strategy.md` |
| Sub-issues and issue hierarchy | `references/sub-issues.md` |
| Release labeling automation | `references/release-labeling.md` |
| gh CLI commands | `references/gh-cli-reference.md` |
| Go, TYPO3, polyglot CI checklists | `references/repo-setup-guide.md` |
| OpenSSF Scorecard, CodeQL, security | `references/security-config.md` |
| Workflow linting (actionlint) | `references/actionlint-guide.md` |
| PR shows too many commits (fork merge base) | `references/pr-commit-cleanup.md` |

---

> **Contributing:** https://github.com/netresearch/github-project-skill

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

github-project

Directory Structure

SKILL.md

Report

Notice